Metodo IShellView::UIActivate (shobjidl_core.h)

Articolo
03/15/2023

Chiamato quando lo stato di attivazione della finestra di visualizzazione viene modificato da un evento che non è causato dalla visualizzazione Shell stessa. Ad esempio, se il tasto TAB viene premuto quando l'albero ha lo stato attivo, la visualizzazione deve essere messa a fuoco.

Sintassi

HRESULT UIActivate(
  UINT uState
);

Parametri

uState

Tipo: UINT

Contrassegno che specifica lo stato di attivazione della finestra. Questo parametro può avere uno dei valori seguenti.

SVUIA_ACTIVATE_FOCUS

Esplora risorse ha appena creato la finestra di visualizzazione con lo stato attivo di input. Ciò significa che la visualizzazione Shell deve essere in grado di impostare le voci di menu appropriate per lo stato attivo.

SVUIA_ACTIVATE_NOFOCUS

La visualizzazione Shell perde lo stato attivo dell'input oppure è stata appena creata senza lo stato attivo dell'input. La visualizzazione Shell deve essere in grado di impostare le voci di menu appropriate per lo stato non incentrato. Ciò significa che non devono essere aggiunti elementi specifici della selezione.

SVUIA_DEACTIVATE

Esplora risorse sta per distruggere la finestra di visualizzazione shell. La visualizzazione Shell deve rimuovere tutte le interfacce utente estese. Questi sono in genere menu uniti e finestre popup senza modalità unite.

SVUIA_INPLACEACTIVATE

La visualizzazione Shell è attiva senza stato attivo. Questo flag viene usato solo quando UIActivate viene esposto tramite l'interfaccia IShellView2 .

Valore restituito

Tipo: HRESULT

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

Commenti

Prima di unire le voci di menu, la visualizzazione Shell in genere associa il messaggio WM_SETFOCUS e chiama il metodo OnViewWindowActive . La visualizzazione Shell non deve associare il messaggio NM_KILLFOCUS per rimergere le voci di menu.

Note per la chiamata di applicazioni

Chiamare questo metodo per informare la visualizzazione di una modifica dello stato di attivazione.

Note per gli implementatori

Usare questo metodo per tenere traccia dello stato di attivazione e modificare qualsiasi comportamento, in base alle esigenze.

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)

Vedi anche

IShellView

Condividi tramite