ART_GUI_toolbar

This function creates an ART toolbar and displays it with its upper-left corner positioned at your defined coordinates of x and y.

Declaration:

	Copy Code
BOOL FAR PASCAL ART_GUI_toolbar_create( HWND hwndParent, int x, int y, HWND FAR* phwndToolBar );

Arguments:

Name	Type	Description
hwndParent	HWND	Set to the Windows handle of the toolbar's parent window.
x	int	An integer variable that sets the x coordinate of the upper-left corner of the toolbar.
y	int	An integer variable that sets the y coordinate of the upper-left corner of the toolbar.
lphWndToolbar	HWND FAR*	A far pointer that returns a Windows handle to the toolbar.

Return Value:

Returns TRUE if toolbar is successfully created; returns FALSE if toolbar not successfully created.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

Annotation

Example:

	Copy Code
HIGEAR hIGear; /* HIGEAR handle of image / BOOL bCreated; / Whether toolbar created/ int x, y; / coordinates of toolbar / / corner / HWND lphWndToolBar; / handle returned for / / toolbar */ bCreated = ART_GUI_toolbar_create( hwndParent, x, y, &lphWndToolBar);

Copy Code

HIGEAR hIGear; /* HIGEAR handle of image */
BOOL bCreated; /* Whether toolbar created*/
int  x, y; /* coordinates of toolbar */
/* corner  */
HWND lphWndToolBar; /* handle returned for */
 /* toolbar  */
bCreated = ART_GUI_toolbar_create( hwndParent, x, y, 
&lphWndToolBar);

Remarks:

You must supply ART with the handle to the parent window to display the toolbar. It returns a Windows handle to the toolbar that you need to pass to the functions starting with ART_GUI_toolbar_...().