Futurebasic/语言/参考/def buttonhelpsettext
✔ 外观 ✔ 标准 ✔ 控制台
DEF BUTTONHELPSETTEXT ( btnID%|& , helpMessage$ )
2003 年 5 月(8.0 版)
此例程将 helpMessage$
字符串与 bntID
指定的按钮关联起来。
帮助标签旨在在 Carbon 中替换帮助气球。它们应该提供关于鼠标指针下按钮操作的简洁而精确的信息。当没有更高优先级的事件挂起时,帮助标签会由系统自动显示,并且在需要处理用户输入时会从屏幕上消失。
因为帮助标签比过时的帮助气球更微妙,所以它们的可见性状态默认为开启。您可以使用 DEF BUTTONHELPSHOW(visibilityFlag)
切换帮助标签的显示。
helpMessage$
字符串参数可能包含转义码来设置显示在屏幕上的帮助标签的对齐方式,以及在按住 Command 键时通常显示的额外消息。字符串的格式可能如下所示:"helpmessage[\§[+]additionalMessage][@alignmentCode]"
,其中:\§
表示第一个帮助消息的结束和第二个帮助消息的开始。可选地,您可以使用 + 符号将第二个消息添加到第一个消息中。 \@ alignmentCode
表示帮助标签相对于指定按钮的位置。您可以使用以下对齐代码之一(分别代表顶部、左侧、底部、右侧和居中)
T; L; B; R; LC(CL); RC(CR); TL; TR; LT; LB; BL; BR; RT; RB。
例如,下面的字符串将在按钮顶部显示一个帮助标签。按住 Command 键会附加一个回车符 + 更多信息。
message = "关闭演示\§+我可以休息一下\@T"
PPC 应用程序使用帮助气球机制来显示与给定按钮相关联的消息。但是,要使气球有效地显示在屏幕上,需要采取额外的步骤。当您的对话框处理程序拦截光标事件时,如果鼠标位于活动窗口中的按钮上,您必须调用 DEF BUTTONHELPDISPLAY
。如果系统级别启用了帮助气球,则会显示帮助消息。请注意,第二个帮助消息在 PPC 中被忽略。
您必须在项目中包含“Subs Help tags.Incl
”才能使此命令可用于您的程序。
DEF BUTTONHELPSETTEXT (_quitBtn, "关闭应用程序")
DEF BUTTONHELPSHOW; DEF BUTTONHELPDISPLAY (PPC)