Ets_Icon_Palette_Create()
Note: Requires OPNET Development Kit
Abstract
Creates a new dialog box containing an icon palette.
Syntax
Ets_Icon_Palette_Create (parent_dbox_ptr, select_proc, cancel_proc, client_state_ptr, options)
| Argument | Type | Description |
|---|---|---|
parent_dbox_ptr |
EtsT_Dbox * |
pointer to an existing dialog box. If this is specified, the icon palette is opened modally with respect to the parent dialog box. |
select_proc |
EtsT_Icon_Palette_Select_Proc |
procedure called when the user selects an icon from the icon palette. See EtsT_Icon_Palette_Select_Proc for the function prototype. |
cancel_proc |
EtsT_Icon_Palette_Cancel_Proc |
procedure called when the user closes or cancels the icon palette. See EtsT_Icon_Palette_Cancel_Proc for the function prototype. |
client_state_ptr |
void * |
arbitrary state that the user wants to pass into the callback when it is called |
options |
int |
not used; set to ETSC_ICON_PALETTE_CREATE_OPT_NONE |
Return Type
EtsT_Compcode
EtsC_Compcode_Failure if an icon palette dialog box could not be opened; EtsC_Compcode_Success otherwise.
Header
ets_api_icon.h
Details
Depending on user action, either the select_proc or cancel_proc will be called. The icon palette until one of these functions has been invoked.