Metodo IDirectManipulationViewport::ActivateConfiguration (directmanipulation.h)

Articolo
08/23/2023

Imposta la configurazione per l'interazione di input.

Sintassi

HRESULT ActivateConfiguration(
  [in] DIRECTMANIPULATION_CONFIGURATION configuration
);

Parametri

[in] configuration

Uno o più valori di DIRECTMANIPULATION_CONFIGURATION che specificano la configurazione di interazione per il viewport.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Una configurazione di interazione specifica il modo in cui il motore di manipolazione risponde all'input e quali manipolazioni sono supportate. È possibile aggiungere al viewport un numero qualsiasi di configurazioni possibili usando AddConfiguration prima dell'elaborazione dell'input.

Le configurazioni possono essere cambiate dall'applicazione in fase di esecuzione usando ActivateConfiguration.

Quando una configurazione non è più necessaria (e non è attualmente attiva), può essere rimossa tramite RemoveConfiguration.

Se una configurazione non è stata aggiunta tramite AddConfiguration, può essere aggiunta automaticamente e quindi attivata chiamando ActivateConfiguration.

Nota Se si verifica l'elaborazione dell'input, questa chiamata avrà esito negativo.

Questo metodo ha esito negativo se è stato specificato un comportamento di trascinamento della selezione .

Un oggetto comportamento di trascinamento della selezione non può essere associato dopo aver chiamato correttamente questo metodo.

Esempio

Nell'esempio seguente viene illustrato come configurare un riquadro di visualizzazione per la panoramica orizzontale.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	directmanipulation.h

Vedi anche

IDirectManipulationViewport

Condividi tramite