CWnd::SendMessageToDescendants

Artículo
02/19/2013

Llame a esta función miembro para enviar el mensaje especificado de Windows a todas las ventanas descendientes.

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

Parámetros

message
Especifica el mensaje que se va a enviar.
wParam
especifica la información mensaje-dependiente adicional.
lParam
especifica la información mensaje-dependiente adicional.
bDeep
Especifica el nivel en el que buscar.Si TRUE, busca de forma recursiva a todos los elementos secundarios; si FALSO, busca únicamente los elementos secundarios inmediatos.
bOnlyPerm
Especifica si el mensaje se reciba las ventanas temporales.si TRUE, ventanas temporales puede recibir el mensaje; si FALSO, solo las ventanas permanentes recibe el mensaje.Para obtener más información sobre las ventanas temporales vea nota técnica 3.

Comentarios

Si bDeep es FALSO, el mensaje se envía solo los elementos secundarios inmediatos de la ventana; si no el mensaje se envía a todas las ventanas descendientes.

Si bDeep y bOnlyPerm son TRUE, la búsqueda continuará bajo las ventanas temporales.En este caso, sólo las ventanas permanentes encontradas durante la búsqueda reciben el mensaje.Si bDeep es FALSO, el mensaje se envía sólo a los elementos secundarios inmediatos de la ventana.

Ejemplo

// 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)