IFileDialogControlEvents::OnItemSelected-Methode (shobjidl.h)

Artikel
08/26/2023

Wird aufgerufen, wenn ein Element in einem Kombinationsfeld ausgewählt wird, wenn ein Benutzer auf eine Optionsschaltfläche (auch als Optionsfeld bezeichnet) klickt oder ein Element aus dem Menü Extras ausgewählt wird.

Syntax

HRESULT OnItemSelected(
  [in] IFileDialogCustomize *pfdc,
  [in] DWORD                dwIDCtl,
  [in] DWORD                dwIDItem
);

Parameter

[in] pfdc

Typ: IFileDialogCustomize*

Ein Zeiger auf die Schnittstelle, über die die Anwendung dem Dialogfeld Steuerelemente hinzugefügt hat.

[in] dwIDCtl

Art: DWORD

Die ID des Steuerelements, in dem der Benutzer eine Auswahl getroffen hat.

[in] dwIDItem

Art: DWORD

Die ID der Auswahl.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Benachrichtigung wird nicht gesendet, wenn der Benutzer ein Element aus dem Dropdownmenü auswähelt, das an die Schaltfläche Öffnen angefügt ist, da die in diesem Fall ausgeführte Aktion immer die gleiche ist: Schließen Sie das Dialogfeld, als hätte der Benutzer einfach auf die Schaltfläche Öffnen geklickt. In diesem Fall kann die Anwendung GetSelectedControlItem aufrufen, um das Element abzurufen, das der Benutzer in diesem Menü ausgewählt hat.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl.h

Freigeben über