Skip to content

Latest commit

 

History

History
95 lines (72 loc) · 4.58 KB

nf-directmanipulation-idirectmanipulationviewport-activateconfiguration.md

File metadata and controls

95 lines (72 loc) · 4.58 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:directmanipulation.IDirectManipulationViewport.ActivateConfiguration
IDirectManipulationViewport::ActivateConfiguration (directmanipulation.h)
Sets the configuration for input interaction.
ActivateConfiguration
ActivateConfiguration method [Direct Manipulation]
ActivateConfiguration method [Direct Manipulation]
IDirectManipulationViewport interface
IDirectManipulationViewport interface [Direct Manipulation]
ActivateConfiguration method
IDirectManipulationViewport.ActivateConfiguration
IDirectManipulationViewport::ActivateConfiguration
directmanipulation.idirectmanipulationviewport_activateconfiguration
directmanipulation/IDirectManipulationViewport::ActivateConfiguration
directmanipulation\idirectmanipulationviewport_activateconfiguration.htm
directmanipulation
16c5902d-dddd-4c40-b1f9-cb432940aa3d
12/05/2018
ActivateConfiguration, ActivateConfiguration method [Direct Manipulation], ActivateConfiguration method [Direct Manipulation],IDirectManipulationViewport interface, IDirectManipulationViewport interface [Direct Manipulation],ActivateConfiguration method, IDirectManipulationViewport.ActivateConfiguration, IDirectManipulationViewport::ActivateConfiguration, directmanipulation.idirectmanipulationviewport_activateconfiguration, directmanipulation/IDirectManipulationViewport::ActivateConfiguration
directmanipulation.h
Windows
Windows 8 [desktop apps only]
Windows Server 2012 [desktop apps only]
DirectManipulation.idl
Windows
19H1
IDirectManipulationViewport::ActivateConfiguration
directmanipulation/IDirectManipulationViewport::ActivateConfiguration
c++
APIRef
kbSyntax
COM
DirectManipulation.h
IDirectManipulationViewport.ActivateConfiguration

IDirectManipulationViewport::ActivateConfiguration

-description

Sets the configuration for input interaction.

-parameters

-param configuration [in]

One or more values from DIRECTMANIPULATION_CONFIGURATION that specify the interaction configuration for the viewport.

-returns

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

-remarks

An interaction configuration specifies how the manipulation engine responds to input and which manipulations are supported. Any number of possible configurations can be added to the viewport using AddConfiguration before processing input.

Configurations can be switched by the application at runtime using ActivateConfiguration.

When a configuration is no longer required (and is not currently active), it can be removed using RemoveConfiguration.

If a configuration has not been added using AddConfiguration, it can be automatically added and then activated by calling ActivateConfiguration.

Note  If input processing is occurring, this call will fail.
 
This method fails if a drag and drop behavior has been specified.

A drag and drop behavior object cannot be attached after successfully calling this method.

Examples

The following example shows how to configure a viewport for horizontal panning.

HRESULT hr = pViewport>ActivateConfiguration(
    DIRECTMANIPULATION_CONFIGURATION_INTERACTION | 
    DIRECTMANIPULATION_CONFIGURATION_TRANSLATION_X);

-see-also

IDirectManipulationViewport