IDirectManipulationViewport::ActivateConfiguration-Methode (directmanipulation.h)
Legt die Konfiguration für die Eingabeinteraktion fest.
Syntax
HRESULT ActivateConfiguration(
[in] DIRECTMANIPULATION_CONFIGURATION configuration
);
Parameter
[in] configuration
Mindestens ein Wert aus DIRECTMANIPULATION_CONFIGURATION , der die Interaktionskonfiguration für den Viewport angibt.
Rückgabewert
Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Eine Interaktionskonfiguration gibt an, wie die Bearbeitungs-Engine auf Eingaben reagiert und welche Bearbeitungen unterstützt werden. Mit AddConfiguration kann dem Viewport eine beliebige Anzahl möglicher Konfigurationen hinzugefügt werden, bevor die Eingabe verarbeitet wird.
Konfigurationen können von der Anwendung zur Laufzeit mithilfe von ActivateConfiguration umgestellt werden.
Wenn eine Konfiguration nicht mehr erforderlich ist (und derzeit nicht aktiv ist), kann sie mithilfe von RemoveConfiguration entfernt werden.
Wenn eine Konfiguration nicht mithilfe von AddConfiguration hinzugefügt wurde, kann sie automatisch hinzugefügt und dann durch Aufrufen von ActivateConfiguration aktiviert werden.
Ein Objekt zum Ziehen und Ablegen kann nach dem erfolgreichen Aufrufen dieser Methode nicht angefügt werden.
Beispiele
Das folgende Beispiel zeigt, wie Sie einen Viewport für horizontales Verschieben konfigurieren.
HRESULT hr = pViewport>ActivateConfiguration(
DIRECTMANIPULATION_CONFIGURATION_INTERACTION |
DIRECTMANIPULATION_CONFIGURATION_TRANSLATION_X);
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | directmanipulation.h |