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:

Annotation Functions: Implementing Automation

 

Implementing Annotations

 

Automated User Interface for Annotations

 

Implementing an Automated Annotation Program

 

Implementing a Non-automated Annotation Program

 

Altering Annotation Object Settings

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