Toolbar_DimItem

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 integer 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 integer Specifies whether the item is dimmed or not dimmed.

Return Value

Name Type Description
status integer Return value indicating whether the function was successful. A negative number indicates that an error occurred.