Edit

Share via

DIRECTMANIPULATION_VIEWPORT_OPTIONS enumeration (directmanipulation.h)

  • Article

Defines the input behavior options for the viewport.

Syntax

typedef enum DIRECTMANIPULATION_VIEWPORT_OPTIONS {
  DIRECTMANIPULATION_VIEWPORT_OPTIONS_DEFAULT = 0,
  DIRECTMANIPULATION_VIEWPORT_OPTIONS_AUTODISABLE = 0x1,
  DIRECTMANIPULATION_VIEWPORT_OPTIONS_MANUALUPDATE = 0x2,
  DIRECTMANIPULATION_VIEWPORT_OPTIONS_INPUT = 0x4,
  DIRECTMANIPULATION_VIEWPORT_OPTIONS_EXPLICITHITTEST = 0x8,
  DIRECTMANIPULATION_VIEWPORT_OPTIONS_DISABLEPIXELSNAPPING = 0x10
} ;

Constants

 
DIRECTMANIPULATION_VIEWPORT_OPTIONS_DEFAULT
Value: 0
No special behaviors. This is the default value used to set or revert to default behavior.
DIRECTMANIPULATION_VIEWPORT_OPTIONS_AUTODISABLE
Value: 0x1
At the end of an interaction, the viewport transitions to DIRECTMANIPULATION_READY and then immediately to DIRECTMANIPULATION_DISABLED. The viewport must be explicitly enabled through the Enable method before the next interaction can be processed.
DIRECTMANIPULATION_VIEWPORT_OPTIONS_MANUALUPDATE
Value: 0x2
Update must be called to redraw the content within the viewport. The content is not updated automatically during an input event.
DIRECTMANIPULATION_VIEWPORT_OPTIONS_INPUT
Value: 0x4
All input from a contact associated with the viewport is passed to the UI thread for processing.
DIRECTMANIPULATION_VIEWPORT_OPTIONS_EXPLICITHITTEST
Value: 0x8
If set, all WM_POINTERDOWN messages are passed to the application for hit testing. Otherwise, Direct Manipulation will process the messages for hit testing against the existing list of running viewports, and the application will not see the input.

Applies only when viewport state is DIRECTMANIPULATION_RUNNING or DIRECTMANIPULATION_INERTIA.
DIRECTMANIPULATION_VIEWPORT_OPTIONS_DISABLEPIXELSNAPPING
Value: 0x10
Specifies that pixel snapping during a manipulation is disabled.

Anti-aliasing can create irregular edge rendering. Artifacts, commonly seen as blurry, or semi-transparent, edges can occur when the location of an edge falls in the middle of a device pixel rather than between device pixels.

Remarks

DIRECTMANIPULATION_VIEWPORT_OPTIONS is used in the SetViewportOptions method. These flags can be combined to set the input behavior for a viewport.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Header directmanipulation.h

See also

Direct Manipulation Enumerations