CWnd::GetNextDlgGroupItem

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

CWnd* GetNextDlgGroupItem(
   CWnd* pWndCtl,
   BOOL bPrevious = FALSE 
) const;
COleControlSiteOrWnd* GetNextDlgGroupItem(
   COleControlSiteOrWnd *pCurSiteOrWnd = NULL
) const;

パラメーター

  • pWndCtl
    検索の開始点として使用するコントロールを識別します。

  • bPrevious
    関数がダイアログ ボックスのコントロールのグループを検索する方法を指定します。**[真]**がグループの前のコントロールを検索する場合は、関数; FALSEのがグループに次のコントロールを検索します。

  • pCurSiteOrWnd
    COleControlSiteOrWnd のコントロールを識別します。COleControlSiteOrWndに関する詳細については、**[コメント]**を参照してください。

戻り値

メンバー関数が正常に終了した場合はグループの前または次のコントロールへのポインター。

返されるポインターは、一時的なポインターです。後で使用するために保存しておくことはできません。

解説

コントロールのグループは WS_GROUP のスタイルで作成されたときに開始し、WS_GROUP のスタイルで作成されていない最後のコントロールによって終了コントロールから。

既定では、GetNextDlgGroupItem のメンバー関数は、次のグループのコントロールへのポインターを返します。pWndCtl がグループの最初のコントロールを識別し、bPrevious が **[真]**場合は、GetNextDlgGroupItem グループの最後のコントロールへのポインターを返します。

[!メモ]

MFC ActiveX コントロールがウィンドウなしの、標準的な ActiveX コントロールとウィンドウをサポートするため、HWND のみによってコントロールを表示するには、足りません。COleControlSiteOrWnd のオブジェクトは、ActiveX コントロール、ウィンドウなしの ActiveX コントロール、またはウィンドウとしてオブジェクトを識別する情報を次のように含まれています:

コントロールまたはウィンドウの型

識別情報

ウィンドウ付きの ActiveX コントロール

HWND を含む、と COleControlSite のオブジェクトに関連付けます。COleControlSiteOrWndm_hWnd のメンバーは、コントロールの HWND、コントロールの COleControlSiteへの m_pSite のメンバーの位置に移動します。

ウィンドウなしの ActiveX コントロール

HWNDは含まれません。コントロールの COleControlSiteへの COleControlSiteOrWnd の点の m_pSite のメンバー、および m_hWnd のメンバーは nullです。

標準的なウィンドウ

HWNDだけが含まれます。COleControlSiteOrWndm_hWnd のメンバーは、ウィンドウの HWND に設定され、m_pSite のメンバーは nullです。

必要条件

ヘッダー: afxwin.h

参照

関連項目

CWnd クラス

階層図

CWnd::GetNextDlgTabItem

GetNextDlgGroupItem