Toolbar_GetCtrlFromDescription

int Toolbar_GetCtrlFromDescription (ToolbarType toolbar, const char *description, int *panel, int *control);

Purpose

Obtains the panel and control identifier for an item on the toolbar with a particular description.

Parameters

Input
Name Type Description
toolbar ToolbarType The specifier for the toolbar.

Obtain this handle from the Toolbar_New or Toolbar_Duplicate functions.
description const char * The description of the toolbar item, as specified in Toolbar_InsertItem.
Output
Name Type Description
panel integer * Returns the ID of the panel that contains the control with the specified label or –1 if no matching item is found.
control integer * Returns the ID of the first control with the specified label or –1 if no matching item is found.

Return Value

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