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 */

L_BOOLL_FAR * pfVisible;

/* 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:

Annotation Functions: Implementing Automation

 

Implementing Annotations

 

Automated User Interface for Annotations

 

Implementing an Automated Annotation Program

 

Implementing a Non-automated Annotation Program

 

Obtaining Annotation Object Information

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);
   }
}