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
In This Topic
    ART_GUI_toolbar_create
    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(
            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_...().