IApplicationDesignModeSettings::TriggerEdgeGesture method (shobjidl_core.h)

Sends a spoofed edge gesture event to the proxy core window on the caller's thread. This gesture toggles the app's app bar, if the app supports one. The caller can specify the type of input that triggered the edge gesture.

You must call IInitializeWithWindow::Initialize to set a proxy core window before calling this method. For a code example, see Display WinRT UI objects that depend on CoreWindow.

Syntax

HRESULT TriggerEdgeGesture(
  [in] EDGE_GESTURE_KIND edgeGestureKind
);

Parameters

[in] edgeGestureKind

Indicates the EDGE_GESTURE_KIND input type that generated the spoofed edge gesture. If touch (EGK_TOUCH) is specified, both the Starting and Completed edge gesture events are sent. Otherwise, only the Completed event is sent. One of the following values:

EGK_TOUCH (0)

The edge gesture event was generated by a swipe on a touch-enabled screen.

EGK_KEYBOARD (1)

The edge gesture event was generated by the Win+Z key sequence on the keyboard.

EGK_MOUSE (2)

The edge gesture event was generated by a right mouse click.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code, including the following:

Return code Description
E_NOT_SET

IInitializeWithWindow::Initialize has not been called to set a proxy core window.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Twinapi.dll

See also

IApplicationDesignModeSettings