L_AnnCreateToolBar
#include "l_bitmap.h"
L_LTANN_API L_INT L_AnnCreateToolBar(hwndParent, pPoint, uAlign, fVisible, phWnd, uButtons, pButtons)
HWND hwndParent; |
/* handle to the parent window */ |
LPPOINT pPoint; |
/* pointer to the POINT structure that positions the window */ |
L_UINT uAlign; |
/* constant for the toolbar alignment */ |
L_BOOL fVisible; |
/* flag that indicates whether the toolbar will be visible */ |
HWND *phWnd; |
/* address of the HWND variable to be updated */ |
L_UINT uButtons; |
/* number of buttons the toolbar will have */ |
pANNBUTTON pButtons; |
/* array of ANNBUTTON structures that contain toolbar button information */ |
Creates an annotation toolbar in the specified window.
This function is available in the Document and Medical Imaging toolkits.
Parameter |
Description |
|
hwndParent |
Handle to the parent window. |
|
pPoint |
Pointer to the POINT structure that specifies the position of the new window in the parent window. Coordinates are relative to the parent window. |
|
uAlign |
Value indicating which corner of the toolbar is located at pPoint. One of the following values: |
|
|
ANNTOOLALIGN_LEFT [0x0000] |
|
|
ANNTOOLALIGN_RIGHT [0x0001] must be combined using the bitwise OR with one of these values: |
|
|
ANNTOOLALIGN_TOP [0x0000] |
|
|
ANNTOOLALIGN_BOTTOM [0x0002] |
|
|
For example, ANNTOOLALIGN_LEFT|ANNTOOLALIGN_TOP indicates that pPoint is the top left point of the toolbar. |
|
fVisible |
Flag that indicates whether the toolbar will be visible. Possible values are: |
|
|
Value |
Meaning |
|
TRUE |
Toolbar will be visible. |
|
FALSE |
Toolbar will not be visible. |
phWnd |
Address of the HWND variable to be updated with the handle to the toolbar window. |
|
uButtons |
Number of buttons that will be in the annotation toolbar. This value is valid only if pButtons is not NULL. |
|
pButtons |
Array of ANNBUTTON structures that contain information about the tool buttons to include in the annotation toolbar. If this is NULL, the default annotation toolbar will be created. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
(Document and Medical) Before calling this function, you must declare a variable of data type HWND. Then, pass the address of the variable in the phWnd parameter. This function will update the variable with the window handle for the toolbar.
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: |
|
|
|
|
|
Topics: |
|
|
|
|
|
|
|
|
Example
For an example, refer to Implementing an Automated Annotation Program. For complete sample code, refer to the ANNOTATE example.