L_AnnGetToolBarButtonVisible
#include "l_bitmap.h"
L_INT EXT_FUNCTION L_AnnGetToolBarButtonVisible(hwndToolBar, uButton, pfVisible)
HWNDToolBar; |
/* window handle for the toolbar */ |
L_UINT uButton; |
/* constant that specifies the tool */ |
/* address of the variable to be updated */ |
Determines whether the specified tool on the annotation toolbar is currently visible. 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. The following are possible values: |
|
|
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 |
pfVisible |
Address of the variable to be updated with a value indicating whether the specified tool is visible. Possible values are: |
|
|
Value |
Meaning |
|
TRUE |
The tool is visible. |
|
FALSE |
The tool is not visible. |
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).
Before calling this function, you must declare a variable of data type L_BOOL. Then, pass the address of the variable in the pfVisible parameter. This function will update the variable with TRUE or FALSE.
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_AnnCreateToolBar, L_AnnGetToolBarChecked, L_AnnSetToolBarChecked, L_AnnSetToolBarButtonVisible |
Topics: |
|
|
|
|
|
|
|
|
|
|
Example
/* This example sets the specified button as the current button
if it is visible. Otherwise, it returns FALSE. */
L_BOOL TestAnnButtonVisible(HWND hwndToolBar, L_UINT uButton)
{
L_BOOL fVisible;
/* See if the specified button is visible */
L_AnnGetToolBarButtonVisible(hwndToolBar, uButton, &fVisible);
/* If it is visible, set it. Otherwise, return FALSE. */
if (fVisible == TRUE)
{
L_AnnSetToolBarChecked(hwndToolBar, uButton);
return(TRUE);
}
else
{
return(FALSE);
}
}