Metodo IDirectManipulationViewport::AddConfiguration (directmanipulation.h)

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.

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

Vedi anche

IDirectManipulationViewport