L_AnnSetToolBarButtonVisible
#include "l_bitmap.h"
L_LTANN_API L_INT L_AnnSetToolBarButtonVisible(hwndToolBar, uButton, fVisible)
HWND hwndToolBar; |
/* window handle for the toolbar */ |
L_UINT uButton; |
/* constant that specifies the tool */ |
L_BOOL fVisible; |
/* flag that indicates whether to make a tool visible */ |
Shows or hides the specified tool on the annotation toolbar. This function is available in the Document/Medical Toolkits.
Parameter |
Description |
|
hwndToolBar |
Window handle for the toolbar. You get the window handle when you create the toolbar using the L_AnnCreateToolBar function. |
|
uButton |
The constant that specifies the tool. Possible values are: |
|
|
Value |
Meaning |
|
ANNTOOL_SELECT |
[0] Selection tool |
|
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 |
fVisible |
Flag that indicates whether to make the specified tool visible on the toolbar. Possible values are: |
|
|
Value |
Meaning |
|
TRUE |
Make the tool visible on the toolbar. |
|
FALSE |
Make the tool invisible. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
When a tool is invisible, other tools in the toolbar are arranged so that no gaps are left, and so that their order is maintained (left-to-right and top-to-bottom, just as text would wrap).
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
Functions: |
L_AnnCreateToolBar, L_AnnGetToolBarChecked, L_AnnSetToolBarChecked, L_AnnGetToolBarButtonVisible |
Topics: |
|
|
|
|
|
|
|
|
|
|
Example
This example hides the button, hot spot, and audio clip tools.
L_INT AnnSetToolBarButtonVisibleExample(HWND hwndToolBar) { L_INT nRet; nRet = L_AnnSetToolBarButtonVisible(hwndToolBar, ANNTOOL_BUTTON , FALSE); if(nRet != SUCCESS) return nRet; nRet = L_AnnSetToolBarButtonVisible(hwndToolBar, ANNTOOL_HOTSPOT, FALSE); if(nRet != SUCCESS) return nRet; nRet = L_AnnSetToolBarButtonVisible(hwndToolBar, ANNTOOL_AUDIO , FALSE); if(nRet != SUCCESS) return nRet; return SUCCESS; }