Funzione EnableWindow (winuser.h)

Articolo
08/27/2023

Abilita o disabilita l'input del mouse e della tastiera nella finestra o nel controllo specificati. Quando l'input è disabilitato, la finestra non riceve input, ad esempio clic del mouse e tasti. Quando l'input è abilitato, la finestra riceve tutti gli input.

Sintassi

BOOL EnableWindow(
  [in] HWND hWnd,
  [in] BOOL bEnable
);

Parametri

[in] hWnd

Tipo: HWND

Handle per la finestra da abilitare o disabilitare.

[in] bEnable

Tipo: BOOL

Indica se abilitare o disabilitare la finestra. Se questo parametro è TRUE, la finestra è abilitata. Se il parametro è FALSE, la finestra è disabilitata.

Valore restituito

Tipo: BOOL

Se la finestra è stata disabilitata in precedenza, il valore restituito è diverso da zero.

Se la finestra non è stata disabilitata in precedenza, il valore restituito è zero.

Commenti

Se la finestra è disabilitata, il sistema invia un messaggio di WM_CANCELMODE . Se lo stato abilitato di una finestra viene modificato, il sistema invia un messaggio WM_ENABLE dopo il messaggio di WM_CANCELMODE. Questi messaggi vengono inviati prima che EnableWindow restituisca. Se una finestra è già disabilitata, le finestre figlio sono disabilitate in modo implicito, anche se non vengono inviate un messaggio di WM_ENABLE .

Prima di poter essere attivata, è necessario abilitare una finestra. Ad esempio, se un'applicazione visualizza una finestra di dialogo senza modalità e ha disabilitato la finestra principale, l'applicazione deve abilitare la finestra principale prima di eliminare la finestra di dialogo. In caso contrario, un'altra finestra riceverà lo stato attivo della tastiera e verrà attivata. Se una finestra figlio è disabilitata, viene ignorata quando il sistema tenta di determinare quale finestra deve ricevere messaggi del mouse.

Per impostazione predefinita, una finestra viene abilitata quando viene creata. Per creare una finestra inizialmente disabilitata, un'applicazione può specificare lo stile WS_DISABLED nella funzione CreateWindow o CreateWindowEx. Dopo aver creato una finestra, un'applicazione può usare EnableWindow per abilitare o disabilitare la finestra.

Un'applicazione può usare questa funzione per abilitare o disabilitare un controllo in una finestra di dialogo. Un controllo disabilitato non può ricevere lo stato attivo della tastiera, né può ottenere l'accesso a esso.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-window-l1-1-4 (introdotta in Windows 10, versione 10.0.14393)