Condividi tramite

Metodo IDirectManipulationViewport::AddConfiguration (directmanipulation.h)

  • Articolo

Aggiunge una configurazione di interazione per il viewport.

Sintassi

HRESULT AddConfiguration(
  [in] DIRECTMANIPULATION_CONFIGURATION configuration
);

Parametri

[in] configuration

Uno dei valori di DIRECTMANIPULATION_CONFIGURATION che specifica 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 alle manipolazioni supportate. È possibile aggiungere qualsiasi numero di configurazioni possibili al viewport usando AddConfiguration prima dell'elaborazione dell'input.

Le configurazioni possono essere spostate 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 e rilascio .

Non è possibile collegare un oggetto comportamento di trascinamento e rilascio dopo aver chiamato correttamente questo metodo.

Non è possibile aggiungere un altro comportamento di trascinamento e rilascio dopo l'aggiunta di uno esistente.

Questo metodo è progettato per consentire a un'applicazione di cambiare configurazioni pre-aggiunte, perché non è possibile modificare una configurazione mentre si sta verificando una manipolazione. Nella maggior parte dei casi è preferibile aggiornare la configurazione usando ActivateConfiguration.

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