CWnd::GetNextDlgGroupItem

[アーティクル]
08/09/2011

ダイアログボックスのコントロールグループ内での前または次のコントロールを検索します。

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 です。