ImageGear for C and C++ on Windows v19.10 - Updated
ART_GUI_toolbar_create
API Reference Guide > ARTGUI Component API Reference > ARTGUI Component Functions Reference > 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(
        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);

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_...().