ToolBar.InsertItem 方法

在可用按钮列表中的指定工具栏按钮项之前插入一个新的工具栏按钮项。

命名空间： XSharp.VO.SDK
程序集： XSharp.VOGUIClasses (在 XSharp.VOGUIClasses.dll 中) 版本：2.22 GA

语法

 VIRTUAL METHOD InsertItem(
	nButtonID,
	nMenuItemID,
	nBeforeID,
	bState,
	bStyle,
	symTB
) AS USUAL CLIPPER

[ClipperCallingConventionAttribute(new string[] { ... })]
public virtual __Usual InsertItem(
	__Usual nButtonID = default,
	__Usual nMenuItemID = default,
	__Usual nBeforeID = default,
	__Usual bState = default,
	__Usual bStyle = default,
	__Usual symTB = default
)

查看代码

参数

nButtonID (Optional): 类型：__Usual
新的工具栏按钮项的ID。要在按钮组之间添加间隔，追加一个标记为 IDT_SEPARATOR 的项。要查看可用的按钮项，参见附录A或在菜单编辑器中打开列表。
nMenuItemID (Optional): 类型：__Usual
新的工具栏按钮项对应的菜单项的ID。
nBeforeID (Optional): 类型：__Usual
新的工具栏按钮项应在其之前插入的工具栏按钮项的ID。如果省略，新的工具栏按钮项将在最后一个工具栏按钮项之后插入。
bState (Optional): 类型：__Usual
** 缺少参数文档 **
bStyle (Optional): 类型：__Usual
** 缺少参数文档 **
symTB (Optional): 类型：__Usual
表示要使用的工具栏的符号名称。默认为主工具栏。

返回值

类型：__Usual
如果成功则返回 TRUE；否则返回 FALSE。

备注

触发按钮点击事件和在状态栏中显示的描述都基于关联菜单的属性。因此，工具栏间接地通过其关联的菜单控制应用程序的操作。通过为每个按钮调用此方法来指定工具栏可能看起来很麻烦。定义工具栏的推荐方法是使用菜单编辑器，它会自动生成布局工具栏的代码。请注意，用户可以使用配置对话框修改工具栏上的按钮项集。程序不需要关心哪些按钮存在，因为事件会像菜单选择一样进入。为了减少“视觉噪音”(不希望的闪烁和闪烁)，工具栏不会立即反映使用 InsertItem() 添加的按钮。相反，您必须调用 Update()，使所有新的按钮一次显示出来。Show() 方法会自动更新显示。对于一次定义并附加到窗口的工具栏，不需要显式调用 Update()，它仅用于在运行时更改其按钮配置的工具栏。

参见

引用

ToolBar 类

XSharp.VO.SDK 命名空间