CWnd::GetDlgItem

This method retrieves a pointer to the specified control or child window in a dialog box or other window. The pointer returned is usually cast to the type of control identified bynID.

CWnd* GetDlgItem ( 
int nID ) 
const; 

void CWnd::GetDlgItem( 
int nID, 
HWND* phWnd ) 
const; 

Parameters

nID

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

phWnd

Specifies a pointer to a child window.

Return Value

Returns a pointer to the given control or child window. If no control with the integer ID given by the nID parameter exists（没有指定的ID的控件，G退出etDlgItem所在的函数）, the value is NULL.

The returned pointer may be temporary and should not be stored for later use.

Remarks

In Windows CE, the CDialog::GetDlgItem method only applies to the immediate child controls of a dialog box. It does not search through nested dialog boxes.

Example

// Uses GetDlgItem to return a pointer to a user interface control.
CEdit* pBoxOne;
pBoxOne = (CEdit*) GetDlgItem(IDC_EDIT1);
GotoDlgCtrl(pBoxOne);

Requirements

  Windows CE versions: 1.0 and later
  Header file: Declared in Afxwin.h
  Platform: H/PC Pro, Palm-size PC, Pocket PC

See Also

CWnd::GetWindow, CWnd::GetDescendantWindow,