This function obtains the dimensions of the image currently in the system clipboard.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI IG_clipboard_dimensions (
LPAT_DIMENSION lpWidth,
LPAT_DIMENSION lpHeight,
LPUINT lpBitsPerPixel
);
|
|
Arguments:
| lpWidth | Far pointer to a variable of type AT_DIMENSION to receive the width in pixels of the image currently in the system clipboard. |
| lpHeight | Far pointer to a variable of type AT_DIMENSION to receive the height in rows of the image currently on the system clipboard. |
| lpBitsPerPixel | Far pointer to a variable of type UINT to receive the bit depth, in bits per pixel, of the image currently on the system clipboard. |
Return Value:
Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.
Supported Raster Image Formats:
This function does not process image pixels.
Sample:
Clipboard
Example:
| Copy Code |
|
|---|---|
AT_DIMENSION nWidth, nHeight; /* holds the images's width and height */ UINT nBpp; /* holds the bits per pixel */ AT_ERRCOUNT nErrcount; /* holds athe returned error count */ BOOL bPasteAvail; /* TRUE if a pasteable image is on the clipboard */ /* If a pasteable image is on the clipboard, get its dimensions: */ IG_clipboard_paste_available ( &bPasteAvail); if ( bPasteAvail ) { nErrcount = IG_clipboard_dimensions ( &nWidth, &nHeight, &nBpp ); } |
|
Remarks:
Prior to calling this function you should call IG_clipboard_paste_available_ex(), to verify that there is an image that can be pasted in the system clipboard.