CWnd::GetNextDlgGroupItem
更新 : 2007 年 11 月
ダイアログ ボックスのコントロール グループ内での前または次のコントロールを検索します。
CWnd* GetNextDlgGroupItem(
CWnd* pWndCtl,
BOOL bPrevious = FALSE
) const;
COleControlSiteOrWnd* GetNextDlgGroupItem(
COleControlSiteOrWnd *pCurSiteOrWnd = NULL
) const;
パラメータ
pWndCtl
検索の開始点となるコントロールを識別します。bPrevious
ダイアログ ボックスのコントロール グループ内での検索方法を指定します。このパラメータが TRUE のときは、グループ内の前のコントロールを検索し、FALSE のときは、グループ内の次のコントロールを検索します。pCurSiteOrWnd
COleControlSiteOrWnd コントロールを識別します。COleControlSiteOrWnd の詳細については、「解説」を参照してください。
戻り値
正常終了した場合は、グループ内の前または次のコントロールへのポインタを返します。
返されるポインタは、一時的なポインタです。後で使用するために保存しておくことはできません。
解説
コントロール グループは、WS_GROUP スタイルで作成されたコントロールから始まり、WS_GROUP スタイル以外で作成されたコントロールで終わります。
既定では、GetNextDlgGroupItem メンバ関数はグループ内の次のコントロールへのポインタを返します。pWndCtl がグループ内の最初のコントロールを指していて、bPrevious が TRUE のときは、GetNextDlgGroupItem 関数はグループ内の最後のコントロールへのポインタを返します。
![]() |
---|
MFC ではウィンドウなしの ActiveX コントロール、標準の ActiveX コントロール、およびウィンドウをサポートするため、HWND だけでのコントロールへの参照では不十分です。COleControlSiteOrWnd オブジェクトには、ウィンドウを持つ ActiveX コントロール、ウィンドウなしの ActiveX コントロール、またはウィンドウとしてオブジェクトを識別する情報が含まれます。これらの情報を次の表に示します。 |
コントロールまたはウィンドウの種類 |
識別情報 |
---|---|
ウィンドウを持つ ActiveX コントロール |
HWND を含み、COleControlSite オブジェクトとその HWND を関連付けます。COleControlSiteOrWnd の m_hWnd メンバはコントロールの HWND に設定され、m_pSite メンバはコントロールの COleControlSite を指します。 |
ウィンドウなしの ActiveX コントロール |
HWND を含みません。COleControlSiteOrWnd の m_pSite メンバはコントロールの COleControlSite を指し、m_hWnd メンバは NULL です。 |
標準のウィンドウ |
HWND だけを含みます。COleControlSiteOrWnd の m_hWnd メンバはウィンドウの HWND に設定され、m_pSite メンバは NULL です。 |
必要条件
ヘッダー : afxwin.h