# 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.