Toolbar_GetAttribute

int Toolbar_GetAttribute (ToolbarType toolbar, int toolbarAttribute, void *attributeValue);

Purpose

This function returns the value of a particular toolbar attribute.

Parameters

Input
Name Type Description
toolbar ToolbarType The specifier for the toolbar for which you want to obtain the attribute value.

Obtain this handle from the Toolbar_New or Toolbar_Duplicate functions.
toolbarAttribute integer The toolbar attribute value to obtain.

In the function panel, when you click the control or press <Enter>, <Spacebar>, or <Ctrl-down arrow>, a dialog box appears containing a hierarchical list of the available attributes. Attributes whose values cannot be obtained are dimmed. Help text is shown for each attribute. To select an attribute, double-click it or select it and then press <Enter>.

If the attribute shown in this ring control has named constants as valid values, you can open a list of them by moving to the Attribute Value control and pressing <Enter>. The Attribute Values dialog box displays the values and value help for the constants.
Output
Name Type Description
attributeValue void * The value of the specified toolbar attribute.

If the attribute shown in this control has named constants as valid values, you can open a list of them by pressing <Enter>. The Attribute Values dialog box displays the values and value help for the constants.

Return Value

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