In This Topic ▼

L_AnnGetToolBarInfo

Summary

Gets information about the annotation toolbar.

Syntax

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnGetToolBarInfo(hwndToolBar, pInfo, uStructSize)

Parameters

HWND hwndToolBar

Window handle for the toolbar. You get the window handle when you create the toolbar using the L_AnnCreateToolBar function.

pANNTOOLBARINFO pInfo

Address of the ANNTOOLBARINFO variable to be updated with the toolbar information.

L_UINT uStructSize

Size in bytes, of the structure pointed to by pInfo, for versioning. Use sizeof (ANNTOOLBARINFO).

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

To change the number of rows, call L_AnnSetToolBarRows. To change the number of columns, call L_AnnSetToolBarColumns.

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.

Example

L_INT AnnGetToolBarInfoExample(L_HWND ToolbarWnd) 
{ 
   L_INT          nRet; 
   ANNTOOLBARINFO Info; 
   L_TCHAR        szMessage[300]; 
 
   nRet = L_AnnGetToolBarInfo(ToolbarWnd, &Info, sizeof(ANNTOOLBARINFO)); 
   if (nRet != SUCCESS) 
      return nRet; 
 
   wsprintf(szMessage, TEXT("There are %d buttons\n%d rows\n%d columns\nin the toolbar."), 
      Info.uButtons, Info.uRows, Info.uColumns); 
   _tprintf(_T("%s"), szMessage); 
 
   nRet = L_AnnSetToolBarColumns(ToolbarWnd, Info.uColumns + 1); 
   if (nRet != SUCCESS) 
      return nRet; 
 
   _tprintf(_T("%s"), TEXT("The toolbar now has an added column.")); 
 
   nRet = L_AnnSetToolBarRows(ToolbarWnd, Info.uRows + 1); 
   if (nRet != SUCCESS) 
      return nRet; 
 
   _tprintf(_T("%s"), TEXT("The toolbar now has one added row.")); 
   return SUCCESS; 
}