CWnd::GetDescendantWindow

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

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

Parameters

  • nID
    Specifies the identifier of the control or child window to be retrieved.

  • bOnlyPerm
    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.

Remarks

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

Requirements

Header: afxwin.h

See Also

Reference

CWnd Class

Hierarchy Chart

CWnd::GetParentFrame

CWnd::IsChild

CWnd::GetDlgItem

Concepts

CWnd Members