IDirectManipulationCompositor interface

Represents a compositor object that associates manipulated content with a drawing surface, such as canvas (Windows Store app using JavaScript) or Canvas (Windows Store app using C++, C#, or Visual Basic).

When to implement

You typically do not need to implement this interface. The system provides an implementation that uses DirectComposition.

Custom implementations of IDirectManipulationCompositor should also implement IDirectManipulationFrameInfoProvider on the same object. During compositor updates, pass this object to Update.

Use CoCreateInstance to get an interface pointer to the implementation.

Note  When implementing a Direct Manipulation object, ensure that the IUnknown implementation supports multithreading through thread-safe reference counting. For more information, see InterlockedIncrement and InterlockedDecrement.

Members

The IDirectManipulationCompositor interface inherits from the IUnknown interface. IDirectManipulationCompositor also has these types of members:

Methods

The IDirectManipulationCompositor interface has these methods.

MethodDescription
AddContent

Associates content with the compositor, assigns a composition device to the content, and specifies the position of the content in the composition tree relative to other composition visuals.

Flush

Commits all pending updates in the compositor to the system for rendering.

RemoveContent

Removes content from the compositor.

SetUpdateManager

Sets the update manager used to send compositor updates to Direct Manipulation.

 

Remarks

The content of a Direct Manipulation viewport must be manually updated during an input event for custom implementations of IDirectManipulationCompositor. Call Update to redraw the content within the viewport.

You specify manual mode on a viewport by calling either of these functions:

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

DirectManipulation.h

IDL

DirectManipulation.idl

IID

IID_IDirectManipulationCompositor is defined as 537A0825-0387-4EFA-B62F-71EB1F085A7E

See also

Direct Manipulation Interfaces

 

 

Community Additions

ADD
Show:
© 2014 Microsoft