IUIX_CmdMenu::InsertItem3 Method

From PDF XChange PDF SDK
Jump to: navigation, search
m (Automatic page editing by robot)
 
(3 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
[[Category:Editor]]
 
[[Category:Editor]]
 
{{#customTitle:IUIX_CmdMenu::InsertItem3 Method}}
 
{{#customTitle:IUIX_CmdMenu::InsertItem3 Method}}
{{#parentPage:PXV:IUIX_CmdMenu#Methods|InsertItem3 Method|method}}
+
{{#parentPage:PXV:IUIX_CmdMenu#Methods|InsertItem3|method}}
{{ToWrite}}
+
 
{{ToReview}}
 
{{ToReview}}
  
The method of interface of PDF-XChange Editor SDK.
+
Inserts new command menu item with given item ID, data, and style.
  
 
== Syntax ==
 
== Syntax ==
<pre class="brush:cpp;gutter:false">HRESULT InsertItem3([in]                              BSTR              pItemID,
+
<pre class="brush:cpp;gutter:false">HRESULT InsertItem3([in]                              BSTR              sItemID,
                     [in]                              BSTR              pText,
+
                     [in]                              BSTR              sText,
 
                     [in]                              IUIX_CmdHandler*  pCmdHandler,
 
                     [in]                              IUIX_CmdHandler*  pCmdHandler,
 
                     [in, defaultvalue(0)]              LONG              nTargetID,
 
                     [in, defaultvalue(0)]              LONG              nTargetID,
 
                     [in, defaultvalue(NULL)]          IUIX_Icon*        pIcon,
 
                     [in, defaultvalue(NULL)]          IUIX_Icon*        pIcon,
                     [in, defaultvalue("")]            BSTR              pTip,
+
                     [in, defaultvalue("")]            BSTR              sTip,
 
                     [in, defaultvalue(-1)]            LONG              nIndexBefore,
 
                     [in, defaultvalue(-1)]            LONG              nIndexBefore,
 
                     [in, defaultvalue(0)]              LONG              nStyle,
 
                     [in, defaultvalue(0)]              LONG              nStyle,
                     [out, retval, defaultvalue(NULL)]  IUIX_CmdMenu**    ppItem);</pre>
+
                     [out, retval, defaultvalue(NULL)]  IUIX_CmdMenu**    pItem);</pre>
  
 
== Parameters ==
 
== Parameters ==
;pItemID
+
;sItemID
:[in]  Value of BSTR.
+
:[in]  Value of BSTR containing the command item ID.
;pText
+
;sText
:[in]  Value of BSTR.
+
:[in]  Value of BSTR containing the text that will be displayed as a command menu item's label.
 
;pCmdHandler
 
;pCmdHandler
:[in]  Pointer to [[PXV:IUIX_CmdHandler|IUIX_CmdHandler]].
+
:[in]  Pointer to [[PXV:IUIX_CmdHandler|IUIX_CmdHandler]] containing the command handler.
 
;nTargetID
 
;nTargetID
:[in, defaultvalue(0)]  Value of LONG.
+
:[in, defaultvalue(0)]  Value of LONG containing command's target ID.
 
;pIcon
 
;pIcon
:[in, defaultvalue(NULL)]  Pointer to [[PXV:IUIX_Icon|IUIX_Icon]].
+
:[in, defaultvalue(NULL)]  Pointer to [[PXV:IUIX_Icon|IUIX_Icon]] containing the command's icon.
;pTip
+
;sTip
:[in, defaultvalue("")]  Value of BSTR.
+
:[in, defaultvalue("")]  Value of BSTR containing the command's tooltip.
 
;nIndexBefore
 
;nIndexBefore
:[in, defaultvalue(-1)]  Value of LONG.
+
:[in, defaultvalue(-1)]  Value of LONG containing the command insertion index.
 
;nStyle
 
;nStyle
:[in, defaultvalue(0)]  Value of LONG.
+
:[in, defaultvalue(0)]  Value of LONG containing the [[PXV:UIX_CmdItemStyleFlags|command style flags]].
;ppItem
+
;pItem
:[out, retval, defaultvalue(NULL)]  Pointer to [[PXV:IUIX_CmdMenu|IUIX_CmdMenu]].
+
:[out, retval, defaultvalue(NULL)]  Pointer to [[PXV:IUIX_CmdMenu|IUIX_CmdMenu]] containing the resulting command menu item.
  
 
== Return Value ==
 
== Return Value ==

Latest revision as of 07:40, 1 April 2016


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

Syntax

HRESULT InsertItem3([in]                               BSTR              sItemID,
                    [in]                               BSTR              sText,
                    [in]                               IUIX_CmdHandler*  pCmdHandler,
                    [in, defaultvalue(0)]              LONG              nTargetID,
                    [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.
pCmdHandler
[in] Pointer to IUIX_CmdHandler containing the command handler.
nTargetID
[in, defaultvalue(0)] Value of LONG containing command's target ID.
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