L_AnnGetToolBarButtons

#include "l_bitmap.h"

L_INT EXT_FUNCTION L_AnnGetToolBarButtons(hwndToolBar, pButtons, puButtons, uStructSize)

HWND hwndToolBar;	/* window handle for the toolbar */
pANNBUTTON pButtons;	/* address of a variable to be updated */
L_UINT L_FAR * puButtons;	/* address of a variable to be updated */
L_UINT uStructSize;	/* size in bytes, of the structure pointed to by puButtons */

Retrieves information about the buttons in the annotation toolbar. This function is available in the Document/Medical Toolkits.

Parameter	Description
hwndToolBar	Window handle for the toolbar. You get the window handle when you create the toolbar using the L_AnnCreateToolBar function.
pButtons	Pointer to an array of ANNBUTTON structures to be updated with information about the buttons in the annotation toolbar.
puButtons	Address of a variable to be updated with the number of buttons in the toolbar (number of entries in the pButtons array).

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Call this function once, with pButtons set to NULL. This will retrieve the number of buttons in the toolbar, updating puButtons. Next, allocate the appropriate amount of memory for the pButtons array, and call this function again to retrieve the button information.

Required DLLs and Libraries

LTANN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 95 / 98 / Me, Windows 2000 / XP.

See Also

Functions:	L_AnnCreateToolBar, L_AnnGetToolBarChecked, L_AnnSetToolBarChecked, L_AnnGetToolBarButtonVisible, L_AnnSetToolBarButtonVisible, L_AnnFreeToolBarButtons, L_AnnSetToolBarButtons, L_AnnGetToolBarInfo, L_AnnSetToolBarColumns, L_AnnSetToolBarRows, L_AnnSetOptions, L_AnnGetOptions
Topics:	Annotation Functions: Working with the Toolbar
	Implementing Annotations
	Implementing an Automated Annotation Program
	Obtaining Annotation Object Information
	New Annotation Features of Version 14.5

Example

For an example, refer to L_AnnFreeToolBarButtons.