L_AnnGetTool
#include "l_bitmap.h"
L_INT EXT_FUNCTION L_AnnGetTool(hObject, puTool)
|
HANNOBJECT hObject; |
/* handle to the annotation automation object */ |
|
/* address of the variable to be updated */ |
Gets the default tool, which is maintained by the automation object. This function is available in the Document/Medical Toolkits.
|
Parameter |
Description |
|
|
hObject |
Handle to the annotation automation object. |
|
|
puTool |
Address of the variable to be updated with the value of the constant for the selected tool. Possible values are: |
|
|
|
Value |
Meaning |
|
|
ANNTOOL_SELECT |
[0] Selection pointer |
|
|
ANNTOOL_LINE |
[1] Line |
|
|
ANNTOOL_RECT |
[2] Rectangle |
|
|
ANNTOOL_ELLIPSE |
[3] Ellipse |
|
|
ANNTOOL_POLYLINE |
[4] Polyline |
|
|
ANNTOOL_POLYGON |
[5] Polygon |
|
|
ANNTOOL_POINTER |
[6] Pointer |
|
|
ANNTOOL_FREEHAND |
[7] Freehand line |
|
|
ANNTOOL_HILITE |
[8] Highlight |
|
|
ANNTOOL_REDACT |
[9] Redaction |
|
|
ANNTOOL_TEXT |
[10] Text |
|
|
ANNTOOL_NOTE |
[11] Note |
|
|
ANNTOOL_STAMP |
[12] Stamp |
|
|
ANNTOOL_BUTTON |
[13] Button |
|
|
ANNTOOL_HOTSPOT |
[14] Hot spot |
|
|
ANNTOOL_AUDIO |
[15] Audio clip |
|
|
ANNTOOL_RULER |
[16] Ruler clip |
|
|
ANNTOOL_CROSSPRODUCT |
[17] Cross product |
|
|
ANNTOOL_POINT |
[18] Point |
|
|
ANNTOOL_PROTRACTOR |
[19] Protractor |
|
|
ANNTOOL_VIDEO |
[20] Video |
|
|
ANNTOOL_PUSHPIN |
[21] Pushpin |
|
|
ANNTOOL_FREEHANDHOTSPOT |
[22] Freehand Hot Spot |
|
|
ANNTOOL_STAMP_FIRST |
[23] First rubber stamp |
|
|
ANNTOOL_STAMP_APPROVED |
[23] Approved rubber stamp |
|
|
ANNTOOL_STAMP_ASSIGNED |
[24] Assigned rubber stamp |
|
|
ANNTOOL_STAMP_CHECKED |
[25] Checked rubber stamp |
|
|
ANNTOOL_STAMP_CLATPRV |
[26] Client Attorney Privilege rubber stamp |
|
|
ANNTOOL_STAMP_COPY |
[27] Copy rubber stamp |
|
|
ANNTOOL_STAMP_DRAFT |
[28] Draft rubber stamp |
|
|
ANNTOOL_STAMP_EXTENDED |
[29] Extended rubber stamp |
|
|
ANNTOOL_STAMP_FAX |
[30] Fax rubber stamp |
|
|
ANNTOOL_STAMP_FAXED |
[31] Faxed rubber stamp |
|
|
ANNTOOL_STAMP_IMPORTANT |
[32] Important rubber stamp |
|
|
ANNTOOL_STAMP_INVOICE |
[33] Invoice rubber stamp |
|
|
ANNTOOL_STAMP_NOTICE |
[34] Notice rubber stamp |
|
|
ANNTOOL_STAMP_OFFICIAL |
[35] Official rubber stamp |
|
|
ANNTOOL_STAMP_ONFILE |
[36] Onfile rubber stamp |
|
|
ANNTOOL_STAMP_PAID |
[37] Paid rubber stamp |
|
|
ANNTOOL_STAMP_PASSED |
[38] Passed rubber stamp |
|
|
ANNTOOL_STAMP_PENDING |
[39] Pending rubber stamp |
|
|
ANNTOOL_STAMP_PROCESSED |
[40] Processed rubber stamp |
|
|
ANNTOOL_STAMP_RECEIVED |
[41] Received rubber stamp |
|
|
ANNTOOL_STAMP_REJECTED |
[42] Rejected rubber stamp |
|
|
ANNTOOL_STAMP_RELEASE |
[43] Release rubber stamp |
|
|
ANNTOOL_STAMP_SENT |
[44] Sent rubber stamp |
|
|
ANNTOOL_STAMP_SHIPPED |
[45] Shipped rubber stamp |
|
|
ANNTOOL_STAMP_TOPSECRET |
[46] Top Secret rubber stamp |
|
|
ANNTOOL_STAMP_URGENT |
[47] Urgent rubber stamp |
|
|
ANNTOOL_STAMP_VOID |
[48] Void rubber stamp |
|
|
ANNTOOL_STAMP_LAST |
[48] the last rubber stamp |
|
|
ANNTOOL_LAST |
[48] the last tool button |
|
|
ANNTOOL_USER |
[0x0100] the first user defined tool |
|
|
ANNTOOL_USERLAST |
[0x0200] the last allowed user defined tool |
Returns
|
SUCCESS |
The function was successful. |
|
< 1 |
An error occurred. Refer to Return Codes. |
Comments
Before calling this function, you must declare a variable of data type L_UINT. Then, pass the address of the variable in the puTool parameter. This function will update the variable with the value of the constant for the selected tool.
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 95 / 98 / Me, Windows 2000 / XP.
See Also
|
Functions: |
|
|
|
L_AnnGetAutoContainer, L_AnnSetDpiX, L_AnnSetDpiY, L_AnnGetDpiX, L_AnnGetDpiY, L_AnnSetTool, L_AnnGetUserMode, L_AnnSetUserMode, L_AnnSetUndoDepth, L_AnnUndo |
|
Topics: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
/* This example gets the automation object’s current tool and assigns it to a global variable. */
HANNOBJECT hAutoObject; /* Automation object */
L_UINT CurrentAutoTool; /* Annotation tool in automation mode */
void TestAnnGetTool(void)
{
L_AnnGetTool(hAutoObject, &CurrentAutoTool);
return;
}