Metodo IShellBrowser::GetControlWindow (shobjidl_core.h)

Articolo
03/02/2024

Ottiene l'handle della finestra in un controllo browser.

Sintassi

HRESULT GetControlWindow(
  UINT id,
  HWND *phwnd
);

Parametri

id

Tipo: UINT

Handle di controllo richiesto. Questo parametro può essere uno dei valori seguenti:

FCW_TOOLBAR

Recupera l'handle della finestra sulla barra degli strumenti del browser.

FCW_STATUS

Recupera l'handle della finestra sulla barra di stato del browser.

FCW_TREE

Recupera l'handle della finestra nella visualizzazione albero del browser.

FCW_PROGRESS

Recupera l'handle della finestra sulla barra di avanzamento del browser.

phwnd

Tipo: HWND*

Indirizzo dell'handle della finestra al controllo Esplora risorse di Windows.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore definito da COM in caso contrario.

Commenti

GetControlWindow viene usato in modo che le visualizzazioni possano modificare direttamente i controlli del browser. FCW_TREE deve essere usato solo per determinare se l'albero è presente.

Note per la chiamata di applicazioni

GetControlWindow viene usato per modificare e testare lo stato delle finestre di controllo. Non inviare messaggi direttamente a questi controlli; usare invece IShellBrowser::SendControlMsg. Prepararsi per questo metodo per restituire NULL. Le versioni successive di Esplora risorse potrebbero non includere una barra degli strumenti, una barra di stato o una finestra ad albero.

Note per gli implementatori

GetControlWindow restituisce l'handle della finestra a questi controlli se presenti nell'implementazione.

Vedere anche IShellBrowser

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 4.0 o successiva)

Condividi tramite