IDirectManipulationViewport::RemoveConfiguration-Methode (directmanipulation.h)
Entfernt eine Interaktionskonfiguration für den Viewport.
Syntax
HRESULT RemoveConfiguration(
[in] DIRECTMANIPULATION_CONFIGURATION configuration
);
Parameter
[in] configuration
Einer der Werte von 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
Diese Methode entfernt eine mögliche Konfiguration, die mithilfe von AddConfiguration hinzugefügt wurde. Diese Methode kann nur aufgerufen werden, wenn die Konfiguration nicht aktiv ist.
Eine Interaktionskonfiguration gibt an, wie die Bearbeitungs-Engine auf Eingaben reagiert und welche Gesten unterstützt werden. Mithilfe von AddConfiguration kann dem Viewport eine beliebige Anzahl von Konfigurationen hinzugefügt werden. 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.
Beispiele
Im folgenden Beispiel wird gezeigt, wie diese Methode verwendet wird.
HRESULT hr = pRegion->RemoveConfiguration(
DIRECTMANIPULATION_CONFIGURATION_INTERACTION |
DIRECTMANIPULATION_CONFIGURATION_TRANSLATION_X);
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | directmanipulation.h |