IDirectManipulationViewport2::AddBehavior-Methode (directmanipulation.h)
Fügt dem Viewport ein Verhalten hinzu und gibt dem Aufrufer ein Cookie zurück.
Syntax
HRESULT AddBehavior(
[in] IUnknown *behavior,
[out, retval] DWORD *cookie
);
Parameter
[in] behavior
Ein Verhalten, das mit der CreateBehavior-Methode erstellt wurde.
[out, retval] cookie
Ein Cookie wird zurückgegeben, damit der Aufrufer dieses Verhalten später entfernen kann. Dadurch kann der Aufrufer alle Verweise auf das Verhalten freigeben und der direkten Bearbeitung eine angemessene Lebensdauer ermöglichen, ähnlich wie bei Ereignishandlern.
Rückgabewert
Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Das Anfügen eines Verhaltens, das bereits an diesen Viewport oder einen anderen Viewport angefügt ist, führt zu einem Fehler.
Hinweise
Ein Verhalten wird sofort nach dem Aufruf von AddBehavior wirksam. Dies muss beim Hinzufügen eines Verhaltens während einer aktiven Manipulations- oder Rägheitsphase berücksichtigt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | directmanipulation.h |