ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / ARTGUI Component API Reference / ARTGUI Component Functions Reference / ART_GUI_toolbar_create_ex
In This Topic
    ART_GUI_toolbar_create_ex
    In This Topic

    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