CWnd::SendMessageToDescendants

Artikel
02/26/2013

Rufen Sie die Memberfunktion auf, um die angegebene Windows-Meldung auf alle Nachfolgerelemente Fenstern zu senden.

void SendMessageToDescendants(
   UINT message,
   WPARAM wParam = 0,
   LPARAM lParam = 0,
   BOOL bDeep = TRUE,
   BOOL bOnlyPerm = FALSE 
);

Parameter

message
Gibt die zu sendende Meldung an.
wParam
Gibt zusätzliche Informationen Meldungabhängigen des Elements an.
lParam
Gibt zusätzliche Informationen Meldungabhängigen des Elements an.
bDeep
Gibt die Ebene an, zu der suchen.Wenn TRUE, rekursiv alle untergeordneten Elemente finden,, wenn FALSE nur unmittelbar untergeordneten Elementen suchen.
bOnlyPerm
Gibt an, ob die Meldung durch temporäre Fenster empfangen wird.Wenn TRUE, temporäre Fenster die Meldung empfangen kann,, wenn FALSE nur permanente Fenster die Meldung empfangen.Weitere Informationen zu temporäre Fenster finden Sie unter Technischer Hinweis 3.

Hinweise

Wenn bDeepFALSE ist, wird die Meldung nur die unmittelbar untergeordneten Element des Fensters gesendet; andernfalls wird die Nachricht an alle Nachfolgerelemente Fenstern gesendet.

Wenn bDeep und bOnlyPermTRUE sind, wird die Suche mit temporären Fenstern fort.In diesem Fall nur die permanenten Fenster, die während der Suche auftreten, wird die Meldung.Wenn bDeepFALSE ist, wird die Meldung nur auf unmittelbar untergeordnete Elemente des Fensters gesendet.

Beispiel

// The following code fragment is from CMyDlg::OnInitDialog
// CMyDlg is derived from CDialog.

// change font of child controls of a dialog
LOGFONT lf = {0};  
// redraw of child controls not needed in OnInitDialog 
// since controls aren't drawn yet.
short int fRedraw = FALSE; 

lf.lfHeight = 15;                 // Request a 15-pixel-high font

// with face name "Arial".
wcscpy_s(lf.lfFaceName, LF_FACESIZE, _T("Arial"));   

m_font.CreateFontIndirect(&lf);   // Create the font. 

SendMessageToDescendants(WM_SETFONT,
   (WPARAM)m_font.m_hObject,  //handle to font
   MAKELONG ((WORD) fRedraw, 0), 
   FALSE);  // send to all descendants(TRUE) or 
            // just children of *this (FALSE)