Toolbar_ActivateItem

int Toolbar_ActivateItem (ToolbarType toolbar, int position, int active, int refresh);

Purpose

Activates or deactivates a particular item on the toolbar. This allows you to have more items on the toolbar than are actually displayed and switch between them.

If you set the refresh parameter to false, the toolbar remains in the old state until you call Toolbar_Display, at which point the toolbar will be refreshed.

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.
active integer Specifies whether the item is to be set active or inactive.
refresh integer Specifies whether to refresh the toolbar.

Return Value

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