Toolbar_DimItem
- Updated2023-02-21
- 1 minute(s) read
int Toolbar_DimItem (ToolbarType toolbar, int position, int dimmed);
Purpose
Specifies whether or not to dim a toolbar item.
This function has the same effect as setting the TOOLBAR_ATTR_DIMMED 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 also can use FRONT_OF_LIST or END_OF_LIST to specify the beginning or the end of the list, respectively. |
| dimmed | int | Specify a nonzero value or select Yes in the function panel to dim the toolbar item. Specify 0 or select No in the function panel otherwise. |
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 4.0 and later
Example
Refer to userint\activex\WebBrowser.cws for an example of using the Toolbar_DimItem function.