Button(3tk) Button(3tk)

Button - 有增强选项的按钮组件

Button pathName ?option value...?

Button 组件向 Tk 按钮组件扩展了新选项。增加了动态帮助 (DynamicHelp) 选项,一个新面型(relief)式样,arm/disarm 回调,和 repeatdelay/repeatinterval 选项。

-armcommand
指定当在 Button 上点击鼠标按钮 1 的时候与 Button 相关联的一个 Tcl 命令。 在 repeatdelay 或 repeatinterval 选项是正整数的时候,如果鼠标指针在这个 按钮之上,则反复的调用这个命令,直到释放鼠标按钮 1。
-command
指定与 Button 相关联的一个 Tcl 命令。典型的当鼠标按钮 1 在 Button 窗口上 释放的时候调用这个命令。
-default
指定缺省 ring 为三种状态之一: normal、active、或 disabled。在活跃状态下 ,用这个平台特定的缺省按钮的外观绘制这个按钮。在普通状态下,用这个平台特 定的非缺省按钮的外观来绘制这个按钮,留出足够的空间来绘制缺省按钮外观。普 通和活跃状态将导致相同大小的按钮。在停用状态下,用非缺省按钮外观来绘制这 个按钮,但不为缺省外观留下空间。停用状态将导致比活跃状态更小的按钮。
-disarmcommand
指定在鼠标按钮 1 释放的时候与 Button 相关联的一个 Tcl 命令。即使鼠标指针 不在 Button 上也要调用这个命令,并且总是在用 command 选项指定的命令之前 。它典型的与 armcommand、repeatdelay 和 repeatinterval 联合使用。
-height
为 Button 指定想要的高度。如果在 Button 中显示一个图象或位图,则这个值单 位是屏幕单位; 对于文本它以行为单位。如果未指定这个选项,则从在其中显示 的图象或位图或文本的大小来计算 Button 的需要的高度。
-helptext
动态帮助的文本。如果为空,则这个组件不能获得帮助。
-helptype
动态帮助的类型。使用 balloon 或 variable.
-helpvar
在 helptype 选项是 variable 的时候使用的变量。
-name
为这个按钮指定一个标准名字。如果在资源数据库中找到选项 *nameName,则从它 的值中提取 text 和 underline 选项。
-relief
为这个组件指定想要的 3-D 效果。可接受的值是按钮面型(relief)的标准值 (raised、sunken、 flat、ridge、solid、和 groove) 和 link,它指定当指针在 按钮外面的时候按钮的面型是 flat 而在指针在里面的时候是 raised。
-state
指定这个 Button 为三种状态之一: normal、active、或 disabled。在普通状态 下,使用 foreground 和 background 选项显示这个 Button。典型的在指针在这 个 Button 之上的时候使用活跃状态。在活跃状态下,使用 activeforeground 和 activebackground 选项显示这个 Button。停用状态意味着这个按钮应当是没有感 觉的(insensitive): 缺省绑定将拒绝激活这个组件并将忽略鼠标按扭按下。在这 种状态下,使用 disabledforeground 和 background 选项显示这个 Button。
-underline
指定在这个按钮的标签中要有下划线的字符的整数索引。0 对应显示的文本的第一 个字符,1 对应下一个字符,以此类推。

在这个按钮的顶层窗口上自动把绑定 <Alt-char> 自动的设置为调用 Button::setfocus。

-width
为 Button 指定想要的宽度。如果在 Button 中显示一个图象或位图,则这个值单 位是屏幕单位; 对于文本它以字符为单位。如果未指定这个选项,则从在其中显 示的图象或位图或文本的大小来计算 Button 的需要的宽度。

pathName cget option
返回用 option 给出的配置选项的当前值。Option 可以是能被建立命令接受的任何值。
pathName configure ?option? ?value option value ...?
查询或修改这个组件的配置选项。如果未指定 option ,则返回描述 pathName 的 所有可获得的选项的一个列表。如果指定了不带 value 的 option,则这个命令返 回描述这个指名的 option 的一个列表(这个列表与未指定 option 所返回的值的 相应的子集是一样的)。如果指定了一个或多个选项-值 对,则这个命令把给定的 组件选项修改为给定的值;在这种情况下这个命令返回一个空串。Option 可以是 能被建立命令接受的任何值。只读选项不可修改。
pathName invoke
如果 Button 的 state 不是停用。它调用这个按钮的命令。用活跃颜色和 sunken 面型(relief)重新显示 Button,并调用 armcommand。接着用普通颜色和它定义的 面型显示 Button,并调用 disarmcommand 接着 command。

在 Button 获得输入聚焦并且用户按 space bar 的时候调用 invoke。

寒蝉退士

2001/06/04

http://cmpp.linuxforum.net

本页面中文版由中文 man 手册页计划提供。
中文 man 手册页计划:https://github.com/man-pages-zh/manpages-zh
tcllib - BWidget