Метод IDirectManipulationViewport::AddConfiguration (directmanipulation.h)
Добавляет конфигурацию взаимодействия для окна просмотра.
Синтаксис
HRESULT AddConfiguration(
[in] DIRECTMANIPULATION_CONFIGURATION configuration
);
Параметры
[in] configuration
Одно из значений из DIRECTMANIPULATION_CONFIGURATION , указывающее конфигурацию взаимодействия для окна просмотра.
Возвращаемое значение
Если метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Конфигурация взаимодействия определяет, как обработчик манипуляций реагирует на входные данные и какие манипуляции поддерживаются. Любое количество возможных конфигураций можно добавить в окно просмотра с помощью AddConfiguration перед обработкой входных данных.
Конфигурации могут быть переключимы приложением во время выполнения с помощью ActivateConfiguration.
Если конфигурация больше не требуется (и в настоящее время не активна), ее можно удалить с помощью команды RemoveConfiguration.
Если конфигурация не была добавлена с помощью AddConfiguration, ее можно автоматически добавить, а затем активировать, вызвав ActivateConfiguration.
Объект поведения перетаскивания не может быть присоединен после успешного вызова этого метода.
Вы не можете добавить другое поведение перетаскивания после того, как уже добавлен существующий.
Этот метод позволяет приложению переключать предварительно добавленные конфигурации, так как конфигурацию нельзя изменить во время манипуляции. В большинстве случаев лучше обновить конфигурацию с помощью ActivateConfiguration.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | directmanipulation.h |