Funzione EnableWindow (winuser.h)

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

Vedi anche

Informazioni concettuali

Createwindow

CreateWindowEx

IsWindowEnabled

Input della tastiera

Riferimento

WM_ENABLE