IUIX_CmdMenu::InsertItem4 Method

UI Layer > Interfaces > IUIX_CmdMenu > IUIX_CmdMenu::InsertItem4 Method

Inserts new command menu item with given item ID, data, and style.

Syntax

HRESULT InsertItem4([in]                               BSTR            sItemID,
                    [in]                               BSTR            sText,
                    [in, defaultvalue(0)]              LONG            nState,
                    [in, defaultvalue(NULL)]           IUIX_Icon*      pIcon,
                    [in, defaultvalue("")]             BSTR            sTip,
                    [in, defaultvalue(-1)]             LONG            nIndexBefore,
                    [in, defaultvalue(0)]              LONG            nStyle,
                    [out, retval, defaultvalue(NULL)]  IUIX_CmdMenu**  pItem);

Parameters

sItemID

[in] Value of BSTR containing the command item ID.

sText

[in] Value of BSTR containing the text that will be displayed as a command menu item's label.

nState

[in, defaultvalue(0)] Value of LONG containing the command item's state.

pIcon

[in, defaultvalue(NULL)] Pointer to IUIX_Icon containing the command's icon.

sTip

[in, defaultvalue("")] Value of BSTR containing the command's tooltip.

nIndexBefore

[in, defaultvalue(-1)] Value of LONG containing the command insertion index.

nStyle

[in, defaultvalue(0)] Value of LONG containing the command style flags.

pItem

[out, retval, defaultvalue(NULL)] Pointer to IUIX_CmdMenu containing the resulting command menu item.

Return Value

Returns S_OK if operation was successful or error code in other cases.

See Also

IUIX_CmdMenu