Toolbar_SetItemAttribute
- Updated2023-02-21
- 2 minute(s) read
int Toolbar_SetItemAttribute (ToolbarType toolbar, int position, int toolbarItemAttribute, ...);
Purpose
Sets the value of a particular toolbar item attribute.
Parameters
| Input | ||
| Name | Type | Description |
| toolbar | ToolbarType | The specifier for the toolbar that contains the item. Obtain this handle from the Toolbar_New or Toolbar_Duplicate functions. |
| position | int | The position of the item in the toolbar. Valid positions are from 1 to the number of items on the toolbar (as returned by Toolbar_GetNumItems). You may also use FRONT_OF_LIST or END_OF_LIST to specify the beginning or the end of the list, respectively. |
| toolbarItemAttribute | int | The toolbar item attribute value to set. In the function panel, when you click the control or press <Enter>, <Spacebar>, or <Ctrl-down arrow>, a dialog box appears containing a hierarchical list of the available attributes. Attributes whose values cannot be obtained are dimmed. Help text is shown for each attribute. To select an attribute, double-click it or select it and then press <Enter>. If the attribute shown in this ring control has named constants as valid values, you can open a list of them by moving to the Attribute Value control and pressing <Enter>. The Attribute Values dialog box displays the values and value help for the constants. |
| attributeValue | ... | The value of the specified toolbar item attribute. If the attribute shown in this control has named constants as valid values, you can open a list of them by pressing <Enter>. The Attribute Values dialog box displays the values and value help for the constants. |
Return Value
| Name | Type | Description |
| status | int | Return value indicating whether the function was successful. A negative number indicates that an error occurred. |
Additional Information
Library: Toolbar
Include file: custctrl\toolbar.h
LabWindows/CVI compatibility: LabWindows/CVI 5.0 and later