L_AnnSetHyperlinkMenuEnable
#include "l_bitmap.h"
L_INT EXT_FUNCTION L_AnnSetHyperlinkMenuEnable (hObject, fEnable, uFlags)
HANNOBJECT hObject; |
/* handle to the annotation automation object */ |
L_BOOL fEnable; |
/* flag that indicates whether to show the hyperlink menu item */ |
L_UINT uFlags; |
/* reserved for future use */ |
Enables or disables the displaying of the hyperlink menu item when you click the right mouse button in design mode. This function is available in the Document/Medical Toolkits.
Parameter |
Description |
|
hObject |
Handle to the annotation automation object. |
|
fEnable |
Flag that indicates whether to display the hyperlink menu item when you right click in design mode. Possible values are: |
|
|
Value |
Meaning |
|
TRUE |
Show the hyperlink menu item when you click the right mouse button in design mode. |
|
FALSE |
Do not show the hyperlink menu item. |
uFlags |
Reserved for future use. You can pass 0. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
This function applies only to automation objects.
Set fEnable to TRUE if you want to bring up a dialog box to select the type of hyperlink an object will have. There is no default way to set the hyperlink type. The text in the menu is given by ANNAUTOTEXT_MENU_HYPERLINK (see L_AnnSetAutoText).
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_AnnGetHyperlinkMenuEnable, L_AnnSetHyperlink, L_AnnGetHyperlinkLen, L_AnnGetHyperlink, L_AnnSetAutoText |
Topics |
|
|
|
|
|
|
|
|
Example
HANNOBJECT hAutoObject; /* Automation object */
void TestAnnHyperlinkMenu(void)
{
L_BOOL bEnabled;
/* toggle display of HyperLink menu item */
L_AnnGetHyperlinkMenuEnable(hAutoObject, &bEnabled);
if(bEnabled)
/* disable menu item */
L_AnnSetHyperlinkMenuEnable (hAutoObject, FALSE, 0);
else
/* enable menu item */
L_AnnSetHyperlinkMenuEnable(hAutoObject, TRUE, 0);
return;
}