ToolBar.AppendItem 方法

 VIRTUAL METHOD AppendItem(
	nButtonID,
	nMenuItemID,
	oBmp,
	nPosition,
	cTitle,
	nImgCount,
	bState,
	bStyle,
	symTB
) AS USUAL CLIPPER

[ClipperCallingConventionAttribute(new string[] { ... })]
public virtual __Usual AppendItem(
	__Usual nButtonID = default,
	__Usual nMenuItemID = default,
	__Usual oBmp = default,
	__Usual nPosition = default,
	__Usual cTitle = default,
	__Usual nImgCount = default,
	__Usual bState = default,
	__Usual bStyle = default,
	__Usual symTB = default
)

参数

nButtonID (Optional)

类型：__Usual
新的工具栏按钮项的ID。要在按钮组之间添加间隔，可以附加一个标记为 IDT_SEPARATOR 的项目。要查看可用的标准按钮项，可以在菜单编辑器中打开列表。对于自定义工具栏按钮，可以附加一个标记为 IDT_CUSTOMBITMAP 的项目。(例如，对于第一个按钮，<nButtonID> 是 IDT_CUSTOMBITMAP + 1；第二个按钮是 IDT_CUSTOMBITMAP + 2，依此类推。)

nMenuItemID (Optional)

类型：__Usual
新的工具栏按钮项对应的菜单项的ID。

oBmp (Optional)

类型：__Usual
包含一个或多个自定义位图的位图对象。位图中的每个按钮都必须是一个16色，20 x 16像素的位图。位图中的第一个按钮必须在像素位置1和20处绘制，第二个按钮在位置21和40处绘制，第三个按钮在位置41和60处绘制，依此类推。(实际上，这是一个按钮的带。)可以将自定义按钮放在单独的位图资源文件中，并为每个按钮创建一个 Bitmap 对象。如果使用这种方法，<nPosition>设置为1。建议在一个位图文件中使用一个按钮的带，因为这样只使用一个句柄。后一种方法将为每个创建的对象使用一个句柄。

nPosition (Optional)

类型：__Usual
自定义工具栏按钮在位图中的位置。如果在<oBmp>中使用的是按钮的带，那么第一个按钮是1，第二个按钮是2，依此类推。如果使用单独的位图，或者如果未指定，<nPosition>为1。 下图说明了一个位图中包含的按钮的带，显示了每个按钮的像素位置和<nPosition>：

cTitle (Optional)

类型：__Usual
如果在工具栏上显示按钮时使用的工具栏按钮的标题，可以指定标题。可以是 TB_TEXTANDICON 或 TB_TEXTONLY 样式。如果未指定，使用默认值 NULL_STRING。

nImgCount (Optional)

类型：__Usual
在<oBmp>中传递的图像中的按钮数量。默认为1。

bState (Optional)

类型：__Usual
按钮的初始状态，启用或禁用。如果启用，用户可以选择按钮。如果禁用，按钮会变暗(灰色)并且不能被选择；直到应用程序启用它，它仍然不可用。默认为启用(TBSTATE_ENABLED)。

bStyle (Optional)

类型：__Usual
工具栏项的可选样式标志。默认情况下，样式会根据其他参数自动推导。但是，通过传递 Windows API 常量，可以强制执行特定的样式。默认为 TBSTYLE_BUTTON。

symTB (Optional)

类型：__Usual
表示要使用的工具栏的符号名称。默认为主工具栏。

返回值

引用