IDirectManipulationViewport::AddConfiguration-Methode (directmanipulation.h)
Fügt eine Interaktionskonfiguration für den Viewport hinzu.
Syntax
HRESULT AddConfiguration(
[in] DIRECTMANIPULATION_CONFIGURATION configuration
);
Parameter
[in] configuration
Einer der Werte aus DIRECTMANIPULATION_CONFIGURATION , der die Interaktionskonfiguration für den Viewport angibt.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Eine Interaktionskonfiguration gibt an, wie die Manipulations-Engine auf Eingaben reagiert und welche Bearbeitungen unterstützt werden. Eine beliebige Anzahl möglicher Konfigurationen kann dem Viewport mithilfe von AddConfiguration hinzugefügt werden, bevor die Eingabe verarbeitet wird.
Konfigurationen können von der Anwendung zur Laufzeit mithilfe von ActivateConfiguration gewechselt 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 nicht angefügt werden, nachdem diese Methode erfolgreich aufgerufen wurde.
Sie können kein weiteres Drag and Drop-Verhalten hinzufügen, nachdem bereits ein vorhandenes hinzugefügt wurde.
Diese Methode ist so konzipiert, dass eine Anwendung vorab hinzugefügte Konfigurationen wechseln kann, da eine Konfiguration während einer Bearbeitung nicht geändert werden kann. In den meisten Fällen ist es besser, die Konfiguration mithilfe von ActivateConfiguration zu aktualisieren.
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 |