IUIX_CmdBar::InsertNewBox Method

UI Layer > Interfaces > IUIX_CmdBar > IUIX_CmdBar::InsertNewBox Method

Inserts new command items box into the command bar.

Syntax

HRESULT InsertNewBox([in]                                       BSTR               pNewBoxID,
                     [in, defaultvalue(-1)]                     LONG               nInsertBefore,
                     [in, defaultvalue(UIX_CmdItemSize_Large)]  UIX_CmdItemSize    nIdealSize,
                     [in, defaultvalue(UIX_CmdItemSize_Small)]  UIX_CmdItemSize    nLowerSize,
                     [in, defaultvalue(0)]                      LONG               nStyle,
                     [out, retval, defaultvalue(NULL)]          IUIX_CmdItemBox**  pItemBox);

Parameters

pNewBoxID

[in] Value of BSTR containing the new command item box'es ID.

nInsertBefore

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

nIdealSize

[in, defaultvalue(UIX_CmdItemSize_Default)] Value of UIX_CmdItemSize containing the optimal size of the command items in the command items box.

nLowerSize

[in, defaultvalue(UIX_CmdItemSize_Default)] Value of UIX_CmdItemSize containing the smallest size of the command items in the command items box.

nStyle

[in, defaultvalue(0)] Value of LONG containing the command items box'es style.

pItemBox

[out, retval, defaultvalue(NULL)] Pointer to IUIX_CmdItemBox containing the newly inserted command box.

Return Value

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

See Also

IUIX_CmdBar