IFileDialogCustomize::StartVisualGroup-Methode (shobjidl_core.h)

  • Artikel

Deklariert eine visuelle Gruppe im Dialogfeld. Nachfolgende Aufrufe einer beliebigen "add"-Methode fügen diese Elemente dieser Gruppe hinzu.

Syntax

HRESULT StartVisualGroup(
  [in] DWORD   dwIDCtl,
  [in] LPCWSTR pszLabel
);

Parameter

[in] dwIDCtl

Art: DWORD

Die ID der visuellen Gruppe.

[in] pszLabel

Typ: LPCWSTR

Ein Zeiger auf einen Puffer, der Text enthält, als Unicode-Zeichenfolge mit Null-Endung, die neben der visuellen Gruppe angezeigt wird.

Rückgabewert

Typ: HRESULT

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

Hinweise

Steuerelemente werden dieser visuellen Gruppe weiterhin hinzugefügt, bis Sie IFileDialogCustomize::EndVisualGroup aufrufen.

Eine visuelle Gruppe kann wie jedes andere Steuerelement ausgeblendet und deaktiviert werden, aber dies wirkt sich auf alle Steuerelemente in ihr aus. Einzelne Mitglieder der visuellen Gruppe können auch einzeln ausgeblendet und deaktiviert werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)