ART_GUI_toolbar_create

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_ex( HWND hwndParent, int x, int y, HWND FAR* phwndToolBar, DWORD dwStyle );

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.
dwStyle	DWORD	Standard Windows style flags: WS_VISIBLE, etc.

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:

None

Example:

	Copy Code
HIGEAR hIGear; /* HIGEAR handle of image / BOOL bCreated; / Whether toolbar created/ int x, y; / coordinates of toolbar's upper-left corner / HWND lphWndToolBar; / handle returned for toolbar*/ bCreated = ART_GUI_toolbar_create_ex( hwndParent, x, y, &lphWndToolBar, WS_VISIBLE);

Copy Code

HIGEAR hIGear; /* HIGEAR handle of image */
BOOL bCreated; /* Whether toolbar created*/
int  x, y; /* coordinates of toolbar's upper-left corner */
HWND lphWndToolBar; /* handle returned for toolbar*/
bCreated = ART_GUI_toolbar_create_ex( hwndParent, x, y, 
&lphWndToolBar,  WS_VISIBLE);

Remarks:

This function is extended version of ART_GUI_toolbar_create() function.

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_. Fifth parameter sets style flags of the toolbar window to be created. For example, toolbar window may be created with such style: