Compartilhar via

Método IDirectManipulationViewport::ActivateConfiguration (directmanipulation.h)

  • Artigo

Define a configuração para interação de entrada.

Sintaxe

HRESULT ActivateConfiguration(
  [in] DIRECTMANIPULATION_CONFIGURATION configuration
);

Parâmetros

[in] configuration

Um ou mais valores de DIRECTMANIPULATION_CONFIGURATION que especificam a configuração de interação para o visor.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Uma configuração de interação especifica como o mecanismo de manipulação responde à entrada e quais manipulações têm suporte. Qualquer número de configurações possíveis pode ser adicionado ao visor usando AddConfiguration antes de processar a entrada.

As configurações podem ser alternadas pelo aplicativo em runtime usando ActivateConfiguration.

Quando uma configuração não é mais necessária (e não está ativa no momento), ela pode ser removida usando RemoveConfiguration.

Se uma configuração não tiver sido adicionada usando AddConfiguration, ela poderá ser adicionada automaticamente e ativada chamando ActivateConfiguration.

Nota Se o processamento de entrada estiver ocorrendo, essa chamada falhará.
 
Esse método falhará se um comportamento de arrastar e soltar tiver sido especificado.

Um objeto de comportamento de arrastar e soltar não pode ser anexado depois de chamar esse método com êxito.

Exemplos

O exemplo a seguir mostra como configurar um visor para o movimento panorâmico horizontal.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho directmanipulation.h

Confira também

IDirectManipulationViewport