description | title | ms.date | keywords | topic_type | api_name | api_type | api_location | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Represents a context menu item of a context menu displayed by WebView. |
WebView2 Win32 C++ ICoreWebView2ContextMenuItem |
06/19/2024 |
IWebView2, IWebView2WebView, webview2, webview, win32 apps, win32, edge, ICoreWebView2, ICoreWebView2Controller, browser control, edge html, ICoreWebView2ContextMenuItem |
|
|
|
|
[!INCLUDE deprecation-note]
interface ICoreWebView2ContextMenuItem
: public IUnknown
Represents a context menu item of a context menu displayed by WebView.
Members | Descriptions |
---|---|
add_CustomItemSelected | Add an event handler for the CustomItemSelected event. |
get_Children | Gets the list of children menu items through a ContextMenuItemCollection if the kind is Submenu. |
get_CommandId | Gets the Command ID for the ContextMenuItem . |
get_Icon | Gets the Icon for the ContextMenuItem in PNG, Bitmap or SVG formats in the form of an IStream. |
get_IsChecked | Gets the checked property of the ContextMenuItem , used if the kind is Check box or Radio. |
get_IsEnabled | Gets the enabled property of the ContextMenuItem . |
get_Kind | Gets the ContextMenuItem kind. |
get_Label | Gets the localized label for the ContextMenuItem . |
get_Name | Gets the unlocalized name for the ContextMenuItem . |
get_ShortcutKeyDescription | Gets the localized keyboard shortcut for this ContextMenuItem. |
put_IsChecked | Sets the checked property of the ContextMenuItem . |
put_IsEnabled | Sets the enabled property of the ContextMenuItem . |
remove_CustomItemSelected | Remove an event handler previously added with add_CustomItemSelected . |
Product | Introduced |
---|---|
WebView2 Win32 | 1.0.1185.39 |
WebView2 Win32 Prerelease | 1.0.1189 |
Add an event handler for the CustomItemSelected
event.
public HRESULT add_CustomItemSelected(ICoreWebView2CustomItemSelectedEventHandler * eventHandler, EventRegistrationToken * token)
CustomItemSelected
event is raised when the user selects this ContextMenuItem
. Will only be raised for end developer created context menu items
Gets the list of children menu items through a ContextMenuItemCollection
if the kind is Submenu.
public HRESULT get_Children(ICoreWebView2ContextMenuItemCollection ** value)
If the kind is not submenu, will return null.
Gets the Command ID for the ContextMenuItem
.
public HRESULT get_CommandId(INT32 * value)
Use this to report the SelectedCommandId
in ContextMenuRequested
event.
Gets the Icon for the ContextMenuItem
in PNG, Bitmap or SVG formats in the form of an IStream.
public HRESULT get_Icon(IStream ** value)
Stream will be rewound to the start of the image data.
Gets the checked property of the ContextMenuItem
, used if the kind is Check box or Radio.
public HRESULT get_IsChecked(BOOL * value)
Gets the enabled property of the ContextMenuItem
.
public HRESULT get_IsEnabled(BOOL * value)
Gets the ContextMenuItem
kind.
public HRESULT get_Kind(COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND * value)
Gets the localized label for the ContextMenuItem
.
public HRESULT get_Label(LPWSTR * value)
Will contain an ampersand for characters to be used as keyboard accelerator.
The caller must free the returned string with CoTaskMemFree
. See API Conventions.
Gets the unlocalized name for the ContextMenuItem
.
public HRESULT get_Name(LPWSTR * value)
Use this to distinguish between context menu item types. This will be the English label of the menu item in lower camel case. For example, the "Save as" menu item will be "saveAs". Extension menu items will be "extension", custom menu items will be "custom" and spellcheck items will be "spellCheck". Some example context menu item names are:
-
"saveAs"
-
"copyImage"
-
"openLinkInNewWindow"
-
"cut"
-
"copy"
-
"paste"
The caller must free the returned string with CoTaskMemFree
. See API Conventions.
Gets the localized keyboard shortcut for this ContextMenuItem.
public HRESULT get_ShortcutKeyDescription(LPWSTR * value)
It will be the empty string if there is no keyboard shortcut. This is text intended to be displayed to the end user to show the keyboard shortcut. For example this property is Ctrl+Shift+I for the "Inspect" ContextMenuItem
.
The caller must free the returned string with CoTaskMemFree
. See API Conventions.
Sets the checked property of the ContextMenuItem
.
public HRESULT put_IsChecked(BOOL value)
Must only be used for custom context menu items that are of kind Check box or Radio.
Sets the enabled property of the ContextMenuItem
.
public HRESULT put_IsEnabled(BOOL value)
Must only be used in the case of a custom context menu item. The default value for this is TRUE
.
Remove an event handler previously added with add_CustomItemSelected
.
public HRESULT remove_CustomItemSelected(EventRegistrationToken token)