CWnd::EnableWindow

Articolo
02/19/2013

Abilita o disabilita il mouse e l'input della tastiera.

BOOL EnableWindow(
   BOOL bEnable = TRUE 
);

Parametri

bEnable
Specifica se la finestra specificata deve essere abilitata o disabilitata.Se questo parametro è TRUE, verrà abilitata.Se questo parametro è FALSE, verrà disabilitata.

Valore restituito

Indica lo stato prima che la funzione membro EnableWindow sia stata chiamata.Il valore restituito è diverso da zero se la finestra precedentemente è disabilitata.Il valore restituito è 0 se la finestra precedentemente è abilitata o si è verificato un errore.

Note

Se l'input è disabilitato, l'input come i clic del mouse e sequenze di tasti viene ignorato.Se l'input è attivato, la finestra elabora l'input.

Se lo stato attivo viene modificato, il messaggio WM_ENABLE viene inviato prima che la funzione restituisce.

Se si disabilita, tutte le finestre figlio in modo implicito vengono disabilitate, benché non siano messaggi inviati WM_ENABLE.

Una finestra deve essere abilitata prima di poter essere attivata.Ad esempio, se un'applicazione viene visualizzata una finestra di dialogo non modale e disattivare la finestra principale, la finestra principale deve essere abilitata prima della finestra di dialogo verrà eliminato.In caso contrario, un'altra finestra otterrà lo stato attivo per l'input e verrà attivata.Se una finestra figlio è disabilitata, viene ignorata quando Windows tenta di determinare la finestra deve ottenere i messaggi del mouse.

Per impostazione predefinita, una finestra viene attivata quando viene creata.Un'applicazione può specificare lo stile WS_DISABLED nella funzione membro CreateEx o Crea per creare una finestra che inizialmente è disabilitata.Dopo che una finestra è stata creata, un'applicazione può inoltre possibile utilizzare la funzione membro EnableWindow per abilitare o disabilitare la finestra.

Un'applicazione può utilizzare questa funzione per abilitare o disabilitare un controllo in una finestra di dialogo.Gli handicappati controllano non possono ricevere lo stato attivo, né è un accesso utente.

Esempio

//CMyFileDialog is a CFileDialog-derived class
//OnInitDialog is the handler for WM_INITDIALOG
BOOL CMyFileDialog::OnInitDialog() 
{
   CFileDialog::OnInitDialog();

   CWnd* pWndParent = GetParent();

   //make sure you add #include <dlgs.h> for IDs 'edt1' & 'stc3'

   //disables the 'file name' edit and static control
   //of the standard file open dialog

   //get handle of 'file name' combobox control & disable it
   CWnd* pWnd = pWndParent->GetDlgItem(cmb13);
   pWnd->EnableWindow(FALSE);

   //get handle of 'file name' static control & disable it
   pWnd = pWndParent->GetDlgItem(stc3);
   pWnd->EnableWindow(FALSE);

   return TRUE;
}