This documentation is archived and is not being maintained.


Call this member function to find the descendant window specified by the given ID.

CWnd* GetDescendantWindow(
   int nID,
   BOOL bOnlyPerm = FALSE 
) const;


Specifies the identifier of the control or child window to be retrieved.
Specifies whether the window to be returned can be temporary. If TRUE, only a permanent window can be returned; if FALSE, the function can return a temporary window. For more information on temporary windows see Technical Note 3.

Return Value

A pointer to a CWnd object, or NULL if no child window is found.


This member function searches the entire tree of child windows, not only the windows that are immediate children.

See Also

CWnd Overview | Class Members | Hierarchy Chart | CWnd::GetParentFrame | CWnd::IsChild | CWnd::GetDlgItem