Windows Dev Center

DIRECTMANIPULATION_VIEWPORT_OPTIONS enumeration

Defines the input behavior options for the viewport.

Syntax


typedef enum _DIRECTMANIPULATION_VIEWPORT_OPTIONS { 
  DIRECTMANIPULATION_VIEWPORT_OPTIONS_DEFAULT               = 0x0000,
  DIRECTMANIPULATION_VIEWPORT_OPTIONS_AUTODISABLE           = 0x0001,
  DIRECTMANIPULATION_VIEWPORT_OPTIONS_MANUALUPDATE          = 0x0002,
  DIRECTMANIPULATION_VIEWPORT_OPTIONS_INPUT                 = 0x0004,
  DIRECTMANIPULATION_VIEWPORT_OPTIONS_EXPLICITHITTEST       = 0x0008,
  DIRECTMANIPULATION_VIEWPORT_OPTIONS_DISABLEPIXELSNAPPING  = 0x0010
} DIRECTMANIPULATION_VIEWPORT_OPTIONS;

Constants

DIRECTMANIPULATION_VIEWPORT_OPTIONS_DEFAULT

No special behaviors. This is the default value used to set or revert to default behavior.

DIRECTMANIPULATION_VIEWPORT_OPTIONS_AUTODISABLE

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

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

All input from a contact associated with the viewport is passed to the UI thread for processing.

DIRECTMANIPULATION_VIEWPORT_OPTIONS_EXPLICITHITTEST

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

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

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Directmanipulation.h

IDL

DirectManipulation.idl

See also

Direct Manipulation Enumerations

 

 

Community Additions

ADD
Show:
© 2015 Microsoft