IShellBrowser::GetControlWindow-Methode (shobjidl_core.h)

Artikel
08/26/2023

Ruft das Fensterhandle für ein Browsersteuerelement ab.

Syntax

HRESULT GetControlWindow(
  UINT id,
  HWND *phwnd
);

Parameter

id

Typ: UINT

Das angeforderte Steuerelementhandle. Dieser Parameter kann einer der folgenden Werte sein:

FCW_TOOLBAR

Ruft das Fensterhandle zur Symbolleiste des Browsers ab.

FCW_STATUS

Ruft das Fensterhandle auf die status leiste des Browsers ab.

FCW_TREE

Ruft das Fensterhandle in die Strukturansicht des Browsers ab.

FCW_PROGRESS

Ruft das Fensterhandle zur Statusanzeige des Browsers ab.

phwnd

Typ: HWND*

Die Adresse des Fensterhandles für das Windows-Explorer-Steuerelement.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen COM-definierten Fehlerwert zurück.

Hinweise

GetControlWindow wird verwendet, damit Ansichten die Steuerelemente des Browsers direkt bearbeiten können. FCW_TREE sollte nur verwendet werden, um zu bestimmen, ob die Struktur vorhanden ist.

Hinweise zum Aufrufen von Anwendungen

GetControlWindow wird verwendet, um den Zustand der Steuerelementfenster zu bearbeiten und zu testen. Senden Sie Nachrichten nicht direkt an diese Steuerelemente. Verwenden Sie stattdessen IShellBrowser::SendControlMsg. Bereiten Sie sich darauf vor, dass diese Methode NULL zurückgibt. Spätere Versionen von Windows Explorer enthalten möglicherweise keine Symbolleiste, status leiste oder Strukturfenster.

Hinweise für Implementierer

GetControlWindow gibt das Fensterhandle an diese Steuerelemente zurück, sofern sie in Ihrer Implementierung vorhanden sind.

Siehe auch IShellBrowser

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shell32.dll (Version 4.0 oder höher)

Freigeben über