Método IDirectManipulationViewport::AddConfiguration (directmanipulation.h)
Adiciona uma configuração de interação para o visor.
Sintaxe
HRESULT AddConfiguration(
[in] DIRECTMANIPULATION_CONFIGURATION configuration
);
Parâmetros
[in] configuration
Um dos valores de DIRECTMANIPULATION_CONFIGURATION que especifica 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.
Um objeto de comportamento de arrastar e soltar não pode ser anexado depois de chamar esse método com êxito.
Não é possível adicionar outro comportamento de arrastar e soltar depois que um já tiver sido adicionado.
Esse método foi projetado para permitir que um aplicativo alterne configurações pré-adicionadas, pois uma configuração não pode ser alterada enquanto uma manipulação está ocorrendo. Na maioria das circunstâncias, é melhor atualizar a configuração usando ActivateConfiguration.
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 |