Share via


CWnd::SetWindowContextHelpId

BOOL SetWindowContextHelpId( DWORD dwContextHelpId );

Return Value

Nonzero if the function is successful; otherwise 0.

Parameters

dwContextHelpId

The help context identifier.

Remarks

Call this member function to associate a help context identifier with the specified window.

If a child window does not have a help context identifier, it inherits the identifier of its parent window. Likewise, if an owned window does not have a help context identifier, it inherits the identifier of its owner window. This inheritance of help context identifiers allows an application to set just one identifier for a dialog box and all of its controls.

Example

BOOL CMyDialog::OnInitDialog()
   {
      CDialog::OnInitDialog();

      //...
      // Associate a help context id with the control.
      // IDC_TESTHELP_CONTROL is the id of the control
      // and HIDC_TESTHELP_CONTROL is its help context
      // id associated with the control.
      CWnd* pWnd = GetDlgItem(IDC_TESTHELP_CONTROL);
      pWndl->SetWindowContextHelpId(HIDC_TESTHELP_CONTROL);

      return TRUE; 
      // Return TRUE unless you set the focus to a control.
      // EXCEPTION: OCX Property Pages should return FALSE.
   }

CWnd OverviewClass MembersHierarchy Chart

See Also   CWnd::GetWindowContextHelpId