DFM_INVOKECOMMAND Nachricht

Wird von der Standardkontextmenüimplementierung gesendet, um die Rückruffunktion anzufordern, die das Menü verarbeitet (LPFNDFMCALLBACK), um einen Menübefehl aufzurufen.

DFM_INVOKECOMMAND
    wParam = (WPARAM)(int) id;          
    lParam = (LPARAM)(LPWSTR) args;
            

Parameter

id [in]

Die Befehls-ID des ausgewählten Menübefehls. Die folgenden Flags werden erkannt:

DFM_CMD_DELETE

Windows Vista und höher. Löschen Sie das aktuelle Element.

DFM_CMD_MOVE

Windows Vista und höher. Verschieben Sie das aktuelle Element.

DFM_CMD_COPY

Windows Vista und höher. Kopieren Sie das aktuelle Element.

DFM_CMD_LINK

Windows Vista und höher. Erstellen Sie einen Link zum aktuellen Element.

DFM_CMD_PROPERTIES

Zeigen Sie die Benutzeroberfläche eigenschaften für das Element an, auf dem das Menü aufgerufen wurde.

DFM_CMD_NEWFOLDER

Wird nicht unterstützt.

DFM_CMD_PASTE

Windows Vista und höher. Fügen Sie ein Element an den aktuellen Speicherort ein.

DFM_CMD_VIEWLIST

Wird nicht unterstützt.

DFM_CMD_VIEWDETAILS

Wird nicht unterstützt.

DFM_CMD_PASTELINK

Windows Vista und höher. Fügen Sie einen Link an der aktuellen Position ein.

DFM_CMD_PASTESPECIAL

Wird nicht unterstützt.

DFM_CMD_MODALPROP

Wird nicht unterstützt.

DFM_CMD_RENAME

Windows Vista und höher. Benennen Sie das aktuelle Element um.

args [in]

Ein Zeiger auf eine NULL-Zeichenfolge, die zusätzliche Argumente für den ausgewählten Menübefehl enthält. Dieser Parameter kann NULL sein.

Rückgabewert

Der Handler für diese Nachricht muss S_FALSE zurückgeben, wenn die Standardimplementierung den Standardhandler für den Befehl aufrufen soll. Geben Sie S_OK zurück, wenn die Nachricht behandelt wurde. Andernfalls wird ein HRESULT-Standardfehlercode zurückgegeben.

Bemerkungen

Diese Nachricht wird entweder an die Rückruffunktion oder das Rückrufobjekt gesendet, je nachdem, wie der Rückruf implementiert wird. Es gibt zwei APIs für die Rückruferstellung: CDefFolderMenu_Create2 , die einen Zeiger auf eine Rückruffunktion verwendet, oder SHCreateDefaultContextMenu , die ein Rückrufobjekt verwendet, das IContextMenuCB unterstützt.

Die Elemente, für die der Befehl aufgerufen wird, werden in einem Datenobjekt bereitgestellt, das an die Rückruffunktion oder an die IContextMenuCB::CallBack-Methode übergeben wird. Dieses Datenobjekt wird von der Datenquelle bereitgestellt, die den Rückruf implementiert. Um die Elemente aus dem Datenobjekt zu extrahieren, verwenden Sie SHCreateShellItemArrayFromDataObject.

DFM_INVOKECOMMANDEX ist eine erweiterte Version dieser Nachricht und stellt weitere Informationen zum Rückruf bereit. Verwenden Sie DFM_INVOKECOMMANDEX , wenn die von dieser Schnittstelle bereitgestellten zusätzlichen Informationen in Ihrer Implementierung benötigt werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Shlobj.h