Метод IDirectManipulationViewport::ActivateConfiguration (directmanipulation.h)

Статья
08/23/2023

Задает конфигурацию для взаимодействия с входным вводом.

Синтаксис

HRESULT ActivateConfiguration(
  [in] DIRECTMANIPULATION_CONFIGURATION configuration
);

Параметры

[in] configuration

Одно или несколько значений из DIRECTMANIPULATION_CONFIGURATION , которые задают конфигурацию взаимодействия для окна просмотра.

Возвращаемое значение

Если метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Конфигурация взаимодействия указывает, как обработчик манипуляций реагирует на входные данные и какие манипуляции поддерживаются. Любое количество возможных конфигураций можно добавить в окно просмотра с помощью команды AddConfiguration перед обработкой входных данных.

Конфигурации могут переключаться приложением во время выполнения с помощью ActivateConfiguration.

Если конфигурация больше не требуется (и в настоящее время не активна), ее можно удалить с помощью команды RemoveConfiguration.

Если конфигурация не была добавлена с помощью AddConfiguration, ее можно автоматически добавить, а затем активировать, вызвав ActivateConfiguration.

Примечание Если выполняется обработка входных данных, этот вызов завершится ошибкой.

Этот метод завершается ошибкой, если задано поведение перетаскивания .

Объект поведения перетаскивания не может быть присоединен после успешного вызова этого метода.

Примеры

В следующем примере показано, как настроить окно просмотра для горизонтального сдвига.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Целевая платформа	Windows
Header	directmanipulation.h

См. также раздел

IDirectManipulationViewport

Поделиться через