CWnd::EnableWindow

Článek
03/04/2013

Povolí nebo zakáže myš a klávesnice.

BOOL EnableWindow(
   BOOL bEnable = TRUE 
);

Parametry

bEnable
Určuje, zda je dané okno povolen nebo zakázán.Pokud je tento parametr TRUE, okna budou povoleny.Pokud je tento parametr FALSE, okno bude zakázán.

Vrácená hodnota

Označuje stav před EnableWindow byla volána funkce členů.Vrácená hodnota je nenulová hodnota, pokud byla předtím zakázána v okně.Vrácená hodnota je 0, pokud byl dříve povolen okna nebo došlo k chybě.

Poznámky

Když je vstup zakázán, vstupní jako klepnutí myší a stisknutí kláves je ignorována.Pokud je povolen vstup, okno zpracovává všechny vstupní.

Pokud je změna stav povoleno, WM_ENABLE zpráva je odeslána před tato funkce vrací.

Pokud zakázána všech podřízených oken jsou implicitně zakázána, ačkoli nejsou odeslány WM_ENABLE zprávy.

Okno musí být povoleno, dříve než může být aktivována.Například aplikace zobrazuje nemodální okno a jeho hlavní okno zakázal, hlavní okno musí být povolena před zničen v dialogovém okně.Další okno jinak získá fokus vstupu a aktivován.Podřízené okno zakázána, je ignorován, při pokusu o určení okna by měla získat myši zprávy.

Ve výchozím nastavení je povoleno okna při jeho vytvoření.Můžete určit aplikaci WS_DISABLED ve stylu vytvořit nebo CreateEx členské funkce vytvořit okno, které zpočátku je zakázáno.Po vytvoření okna aplikace můžete také použít EnableWindow členské funkce povolit nebo zakázat v okně.

Aplikace můžete použít tuto funkci povolit nebo zakázat ovládací prvek v dialogovém okně.Zakázaný ovládací prvek nemůže získat fokus vstupní ani může uživatel přístup.

Příklad

//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;
}