ImageGear for C and C++ on Windows v19.1 - Updated
ART_GUI_toolbar_create_ex
API Reference Guide > ARTGUI Component API Reference > ARTGUI Component Functions Reference > ART_GUI_toolbar_create_ex

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);

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:

MFS_4THICKFRAME | MFS_SYNCACTIVE | WS_POPUP | WS_CAPTION | WS_SYSMENU | MFS_MOVEFRAME | FWS_SNAPTOBARS | dwStyle