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.

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 [29] First rubber stamp
  ANNTOOL_STAMP_APPROVED [29] Approved rubber stamp
  ANNTOOL_STAMP_ASSIGNED [30] Assigned rubber stamp
  ANNTOOL_STAMP_CHECKED [31] Checked rubber stamp
  ANNTOOL_STAMP_CLATPRV [32] Client Attorney Privilege rubber stamp
  ANNTOOL_STAMP_COPY [33] Copy rubber stamp
  ANNTOOL_STAMP_DRAFT [34] Draft rubber stamp
  ANNTOOL_STAMP_EXTENDED [35] Extended rubber stamp
  ANNTOOL_STAMP_FAX [36] Fax rubber stamp
  ANNTOOL_STAMP_FAXED [37] Faxed rubber stamp
  ANNTOOL_STAMP_IMPORTANT [38] Important rubber stamp
  ANNTOOL_STAMP_INVOICE [39] Invoice rubber stamp
  ANNTOOL_STAMP_NOTICE [40] Notice rubber stamp
  ANNTOOL_STAMP_OFFICIAL [41] Official rubber stamp
  ANNTOOL_STAMP_ONFILE [42] Onfile rubber stamp
  ANNTOOL_STAMP_PAID [43] Paid rubber stamp
  ANNTOOL_STAMP_PASSED [44] Passed rubber stamp
  ANNTOOL_STAMP_PENDING [45] Pending rubber stamp
  ANNTOOL_STAMP_PROCESSED [46] Processed rubber stamp
  ANNTOOL_STAMP_RECEIVED [47] Received rubber stamp
  ANNTOOL_STAMP_REJECTED [48] Rejected rubber stamp
  ANNTOOL_STAMP_RELEASE [49] Release rubber stamp
  ANNTOOL_STAMP_SENT [50] Sent rubber stamp
  ANNTOOL_STAMP_SHIPPED [51] Shipped rubber stamp
  ANNTOOL_STAMP_TOPSECRET [52] Top Secret rubber stamp
  ANNTOOL_STAMP_URGENT [53] Urgent rubber stamp
  ANNTOOL_STAMP_VOID [54] Void rubber stamp
  ANNTOOL_STAMP_LAST [55] the last rubber stamp
  ANNTOOL_LAST [56] 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

Win32, x64.

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

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Raster Imaging C API Help