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

    This function shows the dialog that allows you to change an image (device, clipping) rectangle.

    Declaration:

     
    Copy Code
    BOOL ACCUAPI IG_gui_dspl_rect_dlg (
            HWND hWnd, 
            LPAT_IGGUI_DSPL_RECT lpDsplRectData
    );
    

    Arguments:

    Name Type Description
    hWnd HWND A handle of the parent window.
    lpDsplRectData LPAT_IGGUI_DSPL_RECT A pointer to the AT_IGGUI_DSPL_RECT structure.

    Return Value:

    If the user specifies parameters and clicks the OK button, the return value is non-zero. If the user cancels or closes the dialog box or an error occurs, the return value is zero.

    Supported Raster Image Formats:

    All pixel formats supported by ImageGear for C and C++.

    Sample:

    Display, Annotation

    Example:

     
    Copy Code
    #include "IG_gui_common.h"
    AT_IGGUI_DSPL_RECT DsplRect;
    memset (&DsplRect,0,sizeof(DsplRect));
    DsplRect.cbSize = sizeof (DsplRect);
    DsplRect.hWnd = hWnd;
    DsplRect.hIGear = hIGear;
    DsplRect.dwGrpID = nGrpID;
    DsplRect.uRectType = IG_IGGUI_DSPL_RECTTYPE_IMAGE;
    IG_gui_dspl_rect_dlg (hWnd, &DsplRect);
    InvalidateRect (hWnd,NULL,FALSE);
    UpdateWindow (hWnd);