L_AnnGetPredefinedBitmap
#include "l_bitmap.h"
L_LTANN_API L_INT L_AnnGetPredefinedBitmap(uType, pBitmap, uStructSize)
L_UINT uType; |
/* constant that indicates the bitmap to retrieve */ |
pBITMAPHANDLE pBitmap; |
/* pointer to a variable to be updated with the bitmap handle */ |
L_UINT uStructSize; |
/* size of the BITMAPHANDLE structure */ |
Retrieves a copy of the specified predefined bitmap. This function is available in the Document/Medical Toolkits.
Parameter |
Description |
|
uType |
Value that indicates the bitmap to retrieve. Possible values are: |
|
|
Value |
Meaning |
|
ANNBITMAP_POINT |
[0] Predefined metafile for annotation point object |
pBitmap |
Pointer to a variable to be updated with the bitmap handle. |
|
uStructSize |
Size in bytes, of the structure pointed to by pBitmap, for versioning. Use sizeof(BITMAPHANDLE). |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
This function is valid only for the ANNOBJECT_POINT object. You must free the bitmap handle when you are finished, using L_FreeBitmap. Call the L_AnnSetPredefinedBitmap function to change or reset the predefined bitmap.
Required DLLs and Libraries
LTANN For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Platforms
Windows 2000 / XP/Vista.
See Also
Example
This example does the following: 1. Gets the current point bitmap 2. Inverts it 3. Sets the inverted bitmap as the default point bitmap
L_INT AnnGetPredefinedBitmapExample() { BITMAPHANDLE PointBitmap; L_INT nRet = SUCCESS; // Get predefined point bitmap nRet = L_AnnGetPredefinedBitmap(ANNBITMAP_POINT, &PointBitmap, sizeof(BITMAPHANDLE)); if(nRet != SUCCESS) return nRet; // Invert it nRet = L_InvertBitmap(&PointBitmap); if(nRet != SUCCESS) return nRet; // Set as new point bitmap nRet = L_AnnSetPredefinedBitmap(ANNBITMAP_POINT, &PointBitmap); if(nRet != SUCCESS) return nRet; // Free the bitmap L_FreeBitmap(&PointBitmap); MessageBox(NULL, TEXT("Now create a point annotation object. The bitmap is inverted"), TEXT(""), MB_OK); return SUCCESS; }