CMFCPropertyGridCtrl クラス

詳細については、Visual Studio インストールの mfc フォルダーにあるソース コードを参照してください。 たとえば、%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc のようにします。

プロパティをアルファベット順または階層順に表示できる、編集可能なプロパティ グリッド コントロールをサポートします。

構文

class CMFCPropertyGridCtrl : public CWnd

メンバー

パブリック コンストラクター

名前	説明
CMFCPropertyGridCtrl::CMFCPropertyGridCtrl	CMFCPropertyGridCtrl オブジェクトを構築します。
CMFCPropertyGridCtrl::~CMFCPropertyGridCtrl	デストラクターです。

パブリック メソッド

名前	説明
CMFCPropertyGridCtrl::accHitTest	画面上の指定された位置にある子要素または子オブジェクトを取得するために、フレームワークによって呼び出されます。 ( CWnd::accHitTestをオーバーライドします)。
CMFCPropertyGridCtrl::accLocation	指定されたオブジェクトの現在の画面位置を取得するために、フレームワークによって呼び出されます。 ( CWnd::accLocationをオーバーライドします)。
CMFCPropertyGridCtrl::accSelect	選択を変更するため、または指定されたオブジェクトのキーボード フォーカスを移動するために、フレームワークによって呼び出されます。 ( CWnd::accSelectをオーバーライドします)。
CMFCPropertyGridCtrl::AddProperty	プロパティ グリッド コントロールに新しいプロパティを追加します。
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	[色の選択] ダイアログ ボックスを閉じます。
CMFCPropertyGridCtrl::Create	プロパティ グリッド コントロールを作成し、それをプロパティ グリッド コントロール オブジェクトにアタッチします。
CMFCPropertyGridCtrl::DeleteProperty	指定したプロパティをプロパティ グリッド コントロールから削除します。
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	プロパティの一覧の下に表示される説明領域を有効または無効にします。
CMFCPropertyGridCtrl::EnableHeaderCtrl	プロパティ グリッド コントロールの上部にあるヘッダー コントロールを有効または無効にします。
CMFCPropertyGridCtrl::EnsureVisible	プロパティ グリッド コントロールをスクロールし、指定したプロパティが表示されるまでプロパティ項目を展開します。
CMFCPropertyGridCtrl::ExpandAll	すべてのプロパティ グリッド コントロール ノードを展開または折りたたみします。
CMFCPropertyGridCtrl::FindItemByData	ユーザー定義の DWORD 値に関連付けられているプロパティを取得します。
CMFCPropertyGridCtrl::get_accChild	指定された子の IDispatch インターフェイスのアドレスを取得するために、フレームワークによって呼び出されます。 ( CWnd::get_accChildをオーバーライドします)。
CMFCPropertyGridCtrl::get_accChildCount	このオブジェクトに属する子の数を取得するために、フレームワークによって呼び出されます。 ( CWnd::get_accChildCountをオーバーライドします)。
CMFCPropertyGridCtrl::get_accDefaultAction	オブジェクトの既定のアクションを記述する文字列を取得するために、フレームワークによって呼び出されます。 ( CWnd::get_accDefaultActionをオーバーライドします)。
CMFCPropertyGridCtrl::get_accDescription	指定されたオブジェクトの外観を記述する文字列を取得するために、フレームワークによって呼び出されます。 ( CWnd::get_accDescriptionをオーバーライドします)。
CMFCPropertyGridCtrl::get_accFocus	キーボード フォーカスを保持するオブジェクトを取得するために、フレームワークによって呼び出されます。 ( CWnd::get_accFocusをオーバーライドします)。
CMFCPropertyGridCtrl::get_accHelp	オブジェクトの Help プロパティ文字列を取得するためにフレームワークによって呼び出されます。 ( CWnd::get_accHelpをオーバーライドします)。
CMFCPropertyGridCtrl::get_accHelpTopic	指定されたオブジェクトに関連付けられている WinHelp ファイルの完全パスと、そのファイル内の適切なトピックの識別子を取得するために、フレームワークによって呼び出されます。 ( CWnd::get_accHelpTopicをオーバーライドします)。
CMFCPropertyGridCtrl::get_accKeyboardShortcut	指定されたオブジェクトのショートカット キーまたはアクセス キーを取得するために、フレームワークによって呼び出されます。 ( CWnd::get_accKeyboardShortcutをオーバーライドします)。
CMFCPropertyGridCtrl::get_accName	指定されたオブジェクトの名前を取得するために、フレームワークによって呼び出されます。 ( CWnd::get_accNameをオーバーライドします)。
CMFCPropertyGridCtrl::get_accRole	指定されたオブジェクトの役割を記述する情報を取得するために、フレームワークによって呼び出されます。 ( CWnd::get_accRoleをオーバーライドします)。
CMFCPropertyGridCtrl::get_accSelection	このオブジェクトの選択されている子を取得するために、フレームワークによって呼び出されます。 ( CWnd::get_accSelectionをオーバーライドします)。
CMFCPropertyGridCtrl::get_accState	指定されたオブジェクトの現在の状態を取得するために、フレームワークによって呼び出されます。 ( CWnd::get_accStateをオーバーライドします)。
CMFCPropertyGridCtrl::get_accValue	指定されたオブジェクトの値を取得するために、フレームワークによって呼び出されます。 ( CWnd::get_accValueをオーバーライドします)。
CMFCPropertyGridCtrl::GetBkColor	現在のプロパティ グリッド コントロールの背景色を取得します。
CMFCPropertyGridCtrl::GetBoldFont	現在のプロパティ グリッド コントロール内のテキストの Windows フォントを太字で取得します。
CMFCPropertyGridCtrl::GetCurSel	現在選択されているプロパティを取得します。
CMFCPropertyGridCtrl::GetCustomColors	プロパティ グリッド コントロール要素に対して現在定義されているカスタム 色を取得します。
CMFCPropertyGridCtrl::GetDescriptionHeight	プロパティ グリッド コントロールの下部にある説明領域の高さを取得します。
CMFCPropertyGridCtrl::GetDescriptionRows	現在のプロパティ グリッド コントロールの説明領域内の行数を取得します。
CMFCPropertyGridCtrl::GetHeaderCtrl	現在のプロパティ グリッド コントロールを表示するためにフレームワークが使用する内部 CMFCHeaderCtrl オブジェクトを取得します。
CMFCPropertyGridCtrl::GetHeaderHeight	プロパティ グリッド コントロール ヘッダーの高さを取得します。
CMFCPropertyGridCtrl::GetLeftColumnWidth	各プロパティの名前を含む、現在のプロパティ グリッド コントロールの左列の幅を取得します。
CMFCPropertyGridCtrl::GetListRect	プロパティ グリッド コントロールの外接する四角形を取得します。
CMFCPropertyGridCtrl::GetProperty	プロパティ グリッド コントロール項目の指定したインデックスに対応するプロパティ オブジェクトへのポインターを取得します。
CMFCPropertyGridCtrl::GetPropertyColumnWidth	プロパティ値を含む列の現在の幅を取得します。
CMFCPropertyGridCtrl::GetPropertyCount	プロパティ グリッド コントロール内のプロパティの数を取得します。
CMFCPropertyGridCtrl::GetRowHeight	プロパティ グリッド コントロール内の行の高さを取得します。
CMFCPropertyGridCtrl::GetScrollBarCtrl	プロパティ グリッド コントロールのスクロール バー コントロールへのポインターを取得します。 ( CWnd::GetScrollBarCtrlをオーバーライドします)。
CMFCPropertyGridCtrl::GetTextColor	現在のプロパティ グリッド コントロールのプロパティ項目のテキストの色を取得します。
CMFCPropertyGridCtrl::GetThisClass	フレームワークによって、このクラス型に関連付けられている CRuntimeClass オブジェクトへのポインターを取得するために使用されます。
CMFCPropertyGridCtrl::HitTest	指定したポイントがアイテム内にある場合に、プロパティ グリッド コントロール項目に対応するプロパティ オブジェクトへのポインターを取得します。 このメソッドは、ポイントを含むプロパティ グリッド コントロール内の領域も示します。
CMFCPropertyGridCtrl::InitHeader	現在のプロパティ グリッド コントロールを表示するためにフレームワークが使用する内部 CMFCHeaderCtrl オブジェクトを初期化します。
CMFCPropertyGridCtrl::IsAlphabeticMode	プロパティ グリッド コントロールがアルファベット モードかどうかを示します。
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	プロパティ グリッド コントロールの説明領域を表示するかどうかを示します。
CMFCPropertyGridCtrl::IsGroupNameFullWidth	各プロパティ グループ名が現在のプロパティ グリッド コントロールの幅全体に表示されるかどうかを示します。
CMFCPropertyGridCtrl::IsHeaderCtrl	ヘッダー コントロールが表示されるかどうかを示します。
CMFCPropertyGridCtrl::IsMarkModifiedProperties	プロパティ グリッド コントロールで変更されたプロパティを表示する方法を示します。
CMFCPropertyGridCtrl::IsShowDragContext	ユーザーが列のサイズを変更するときに、フレームワークが現在のプロパティ グリッド コントロールの名前と値の列を再描画するかどうかを示します。
CMFCPropertyGridCtrl::IsVSDotNetLook	プロパティ グリッド コントロールの外観が、VS .NET で使用されるスタイル内にあるかどうかを示します。
CMFCPropertyGridCtrl::MarkModifiedProperties	変更されたプロパティを表示する方法を指定します。
CMFCPropertyGridCtrl::PreTranslateMessage	クラス CWinApp によって、 TranslateMessage および windows 関数にディスパッチされる前にウィンドウ メッセージ DispatchMessage 変換するために使用されます。 ( CWnd::PreTranslateMessageをオーバーライドします)。
CMFCPropertyGridCtrl::RemoveAll	プロパティ グリッド コントロールからすべてのプロパティ オブジェクトを削除します。
CMFCPropertyGridCtrl::ResetOriginalValues	すべてのプロパティの元の値を復元します。
CMFCPropertyGridCtrl::SetAlphabeticMode	アルファベットモードを設定またはリセットします。
CMFCPropertyGridCtrl::SetBoolLabels	ブール型ラベルのテキストを指定します。
CMFCPropertyGridCtrl::SetCurSel	プロパティ グリッド コントロール内のプロパティを選択します。
CMFCPropertyGridCtrl::SetCustomColors	さまざまなプロパティ グリッド コントロール要素のカスタム 色を指定します。
CMFCPropertyGridCtrl::SetDescriptionRows	現在のプロパティ グリッド コントロールの説明セクションに表示する行数を指定します。
CMFCPropertyGridCtrl::SetGroupNameFullWidth	現在のプロパティ グリッド コントロールのプロパティ グループのカテゴリ名の全幅を表示するかどうかを指定します。
CMFCPropertyGridCtrl::SetListDelimiter	プロパティ値の一覧で区切り記号として使用される文字を定義します。
CMFCPropertyGridCtrl::SetShowDragContext	ユーザーが列のサイズを変更するときに、フレームワークが現在のプロパティ グリッド コントロールの名前と値の列を再描画するかどうかを指定します。
CMFCPropertyGridCtrl::SetVSDotNetLook	プロパティ グリッド コントロールの外観を VS .NET で使用されるスタイルに設定します。
CMFCPropertyGridCtrl::UpdateColor	現在選択されている色プロパティの色の値を設定します。

保護メソッド

名前	説明
CMFCPropertyGridCtrl::AdjustLayout	プロパティ グリッド コントロールとそのプロパティを再描画します。
CMFCPropertyGridCtrl::CompareProps	プロパティを並べ替えるために、プロパティ グリッド コントロールによって呼び出されます。
CMFCPropertyGridCtrl::EditItem	ユーザーがプロパティの変更を開始したときにフレームワークによって呼び出されます。
CMFCPropertyGridCtrl::EndEditItem	ユーザーがプロパティの変更を停止したときにフレームワークによって呼び出されます。
CMFCPropertyGridCtrl::Init	プロパティ グリッド コントロールを初期化するためにフレームワークによって呼び出されます。
CMFCPropertyGridCtrl::OnChangeSelection	現在の選択範囲が変更されたときにフレームワークによって呼び出されます。
CMFCPropertyGridCtrl::OnClickButton	プロパティ ボタンがクリックされたときにフレームワークによって呼び出されます。
CMFCPropertyGridCtrl::OnDrawBorder	プロパティ グリッド コントロールの周囲に境界線を描画するためにフレームワークによって呼び出されます。
CMFCPropertyGridCtrl::OnDrawDescription	説明領域を描画し、説明テキストを表示するためにフレームワークによって呼び出されます。
CMFCPropertyGridCtrl::OnDrawList	プロパティ グリッド コントロール内のプロパティの一覧を表示するためにフレームワークによって呼び出されます。
CMFCPropertyGridCtrl::OnDrawProperty	プロパティを表示するためにフレームワークによって呼び出されます。
CMFCPropertyGridCtrl::OnPropertyChanged	プロパティの値が変更されたときにフレームワークによって呼び出されます。
CMFCPropertyGridCtrl::OnSelectCombo	コンボ ボックス コントロールを含むプロパティが選択されている場合に、フレームワークによって呼び出されます。
CMFCPropertyGridCtrl::ValidateItemData	プロパティ データを検証するためにフレームワークによって呼び出されます。

解説

CMFCPropertyGridCtrl クラスには、CMFCPropertyGridProperty クラスから派生した編集可能なプロパティを含むプロパティ グリッド コントロールが表示されます。 各プロパティは型を表し、サブ項目を含めることができます。 プロパティ グリッド コントロールは、選択したプロパティの説明を表示できる、下部にあるサイズ変更可能な領域をサポートしています。

プロパティ グリッド コントロールを使用するには、 CMFCPropertyGridCtrl オブジェクトを作成し、 CMFCPropertyGridCtrl::Create メソッドを呼び出します。 CMFCPropertyGridCtrl::AddProperty メソッドを使用して、プロパティをリストに追加します。

Selection プロパティ

プロパティ項目は、値を表す代わりに、ユーザーが色、ファイル、またはフォントを選択できるようにするダイアログ ボックスを開始できます。

次の表に、4 つの選択プロパティの種類を示します。

クラス	説明
CMFCPropertyGridProperty クラス	文字列、ブール値、日付などの値を指定するために使用される汎用プロパティ。
CMFCPropertyGridColorProperty クラス	色の値を選択するために使用されるプロパティ。
CMFCPropertyGridFileProperty クラス	ファイルの選択に使用されるプロパティ。
CMFCPropertyGridFontProperty クラス	フォントの選択に使用されるプロパティ。

図

次の図は、2 つの方法でプロパティを表示するプロパティ グリッド コントロールを示しています。 最初の図では、プロパティが階層的に表示され、2 番目の図ではプロパティがアルファベット順に表示されます。

例

次の例では、 CMFCPropertyGridCtrl クラスのさまざまなメソッドを使用して、プロパティ グリッド コントロール オブジェクトを構成する方法を示します。 この例では、ヘッダー コントロールを有効にし、説明領域を有効にして、プロパティ グリッド コントロールの外観を設定する方法を示します。 この例では、コントロールに対してアルファベット モードを設定し、コントロールが含まれるすべてのプロパティをプロパティ名で並べ替える方法と、プロパティ グリッド コントロールのさまざまな要素のカスタム色を設定する方法も示します。 この例は、 New Controls サンプルの一部です。

CMFCPropertyGridCtrl m_wndPropList;

m_wndPropList.EnableHeaderCtrl();
m_wndPropList.EnableDescriptionArea();
m_wndPropList.SetVSDotNetLook(m_bDotNetLook);
// BOOL m_bMarkChanged
m_wndPropList.MarkModifiedProperties(m_bMarkChanged);
// BOOL m_bPropListCategorized
m_wndPropList.SetAlphabeticMode(!m_bPropListCategorized);
// BOOL m_bShowDragContext
m_wndPropList.SetShowDragContext(m_bShowDragContext);

// BOOL m_bMarkSortedColumn
m_wndList.EnableMarkSortedColumn(m_bMarkSortedColumn);

// BOOL m_bPropListCustomColors
// set custom colors for various elements of the property grid control
if (m_bPropListCustomColors)
{
   m_wndPropList.SetCustomColors(RGB(228, 243, 254), RGB(46, 70, 165), RGB(200, 236, 209), RGB(33, 102, 49), RGB(255, 229, 216), RGB(128, 0, 0), RGB(159, 159, 255));
}
else
{
   COLORREF c = (COLORREF)-1;
   m_wndPropList.SetCustomColors(c, c, c, c, c, c, c);
}

m_wndPropList.RedrawWindow();

// restore original values of the properties
m_wndPropList.ResetOriginalValues();

継承階層

CObject

CCmdTarget

CWnd

CMFCPropertyGridCtrl

要件

ヘッダー: afxpropertygridctrl.h

CMFCPropertyGridCtrl::accSelect

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

パラメーター

[入力] flagsSelect
[入力] varChild\

戻り値

解説

CMFCPropertyGridCtrl::AddProperty

プロパティ グリッド コントロールに新しいプロパティを追加します。

int AddProperty(
    CMFCPropertyGridProperty* pProp,
    BOOL bRedraw=TRUE,
    BOOL bAdjustLayout=TRUE);

パラメーター

pProp
[in]プロパティへのポインター。

bRedraw
[入力] TRUE プロパティを直ちに再描画する場合。それ以外の場合は FALSE。 既定値は TRUE です。

bAdjustLayout
[入力] TRUE プロパティのテキストと値を描画し、プロパティを描画する方法を再計算するには、既存の計算を使用してプロパティを描画 FALSE 。 既定値は TRUE です。

戻り値

このメソッドが成功した場合、プロパティが追加されるプロパティ グリッド コントロール内の位置の 0 から始まるインデックス。それ以外の場合は -1。

解説

このメソッドは、プロパティ グリッド コントロールのプロパティの一覧の末尾に、指定したプロパティへのポインターを追加します。 グリッド コントロールが破棄される前に、プロパティを破棄したり、スコープ外に移動したりしないでください。 プロパティ グリッド コントロールが完了したら、 CMFCPropertyGridCtrl::RemoveAll を呼び出して、追加されたすべてのプロパティを削除します。 指定したプロパティが既にリストに追加されている場合、AddProperty メソッドは失敗します。

CMFCPropertyGridCtrl::AdjustLayout

プロパティ グリッド コントロールとそのプロパティを再描画します。

virtual void AdjustLayout();

解説

このメソッドは、イメージ、フォント、コントロールなど、プロパティ グリッド コントロール全体とそのプロパティを描画する方法を再計算します。

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

void AlwaysShowUserToolTip(BOOL bShow = TRUE);

パラメーター

[入力] bShow\

解説

CMFCPropertyGridCtrl::CloseColorPopup

[色の選択] ダイアログ ボックスを閉じます。

virtual void CloseColorPopup();

解説

[色の選択] ダイアログ ボックスの詳細については、「 CMFCPropertyGridColorProperty クラスを参照してください。

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

CMFCPropertyGridCtrl オブジェクトを構築します。

CMFCPropertyGridCtrl();

戻り値

解説

CMFCPropertyGridCtrl::CompareProps

プロパティを並べ替えるために、プロパティ グリッド コントロールによって呼び出されます。

virtual int CompareProps(
    const CMFCPropertyGridProperty* pProp1,
    const CMFCPropertyGridProperty* pProp2) const;

パラメーター

pProp1
プロパティへのポインター。

pProp2
プロパティへのポインター。

戻り値

戻り値	説明
< 0	pProp1 パラメーターの名前が、pProp2 パラメーターの名前より小さい。
0	pProp1 パラメーターの名前は、pProp2 パラメーターの名前と同じです。
> 0	pProp1 オブジェクトの名前が、pProp2 パラメーターの名前より大きい。

解説

既定では、このメソッドは CString::Compare メソッドを使用して、指定されたパラメーターの CMFCPropertyGridProperty::m_strName メンバーを比較します。

CMFCPropertyGridCtrl::Create

プロパティ グリッド コントロールを作成し、それをプロパティ グリッド コントロール オブジェクトにアタッチします。

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

パラメーター

dwStyle
[in]ウィンドウ スタイルのビットごとの組み合わせ "or" (|。

rect
[in] pParentWndのクライアント座標で、ウィンドウのサイズと位置を指定する外接する四角形。

pParentWnd
[in]親ウィンドウへのポインター。 NULL にすることはできません。

nID
[in]子ウィンドウの ID。

戻り値

TRUE ウィンドウが正常に作成された場合。それ以外の場合は FALSE。

解説

プロパティ グリッド コントロールを作成するには、最初に CMFCPropertyGridCtrl::CMFCPropertyGridCtrl を呼び出してプロパティ グリッド オブジェクトを作成します。 次に、CMFCPropertyGridCtrl::Create を呼び出します。

例

次の例では、CMFCPropertyGridCtrl クラスで Create メソッドを使用する方法を示します。 この例は、 New Controls サンプルの一部です。

// CRect rectPropList
// CMFCPropertyGridCtrl m_wndPropList
// The this pointer points to a CPage5 class which extends the CMFCPropertyPage class.
m_wndPropList.Create(WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_BORDER, rectPropList, this, (UINT)-1);

CMFCPropertyGridCtrl::DeleteProperty

指定したプロパティをプロパティ グリッド コントロールから削除します。

BOOL DeleteProperty(
    CMFCPropertyGridProperty*& pProp,
    BOOL bRedraw=TRUE,
    BOOL bAdjustLayout=TRUE);

パラメーター

pProp
[in]プロパティへのポインター。

bRedraw
[入力] TRUE プロパティ グリッド コントロールを再描画する場合。それ以外の場合は FALSE。 既定値は TRUE です。

bAdjustLayout
[入力] TRUE プロパティ グリッド コントロール内のすべてのテキスト、画像、項目を描画し、コントロールを描画する方法を再計算する場合。それ以外の場合は FALSE。 既定値は TRUE です。

戻り値

TRUE このメソッドが成功した場合。それ以外の場合は FALSE。

解説

プロパティ グリッド コントロールからプロパティとサブ項目を削除するには、このメソッドを使用します。

CMFCPropertyGridCtrl::DrawControlBarColors

BOOL DrawControlBarColors() const;

戻り値

解説

CMFCPropertyGridCtrl::EditItem

ユーザーがプロパティの変更を開始したときにフレームワークによって呼び出されます。

virtual BOOL EditItem(
    CMFCPropertyGridProperty* pProp,
    LPPOINT lptClick=NULL);

パラメーター

pProp
[in]プロパティへのポインター。

lptClick
[in]ユーザーが編集操作を開始するためにクリックしたプロパティ グリッド コントロール上のポイント。 ポイントは、コントロールのクライアント座標内にあります。 既定値は NULL です。

戻り値

TRUE メソッドが成功した場合。それ以外の場合は FALSE。

解説

CMFCPropertyGridCtrl::EnableDescriptionArea

プロパティ グリッド コントロールのプロパティの一覧の下に表示される説明領域を有効または無効にします。

void EnableDescriptionArea(BOOL bEnable=TRUE);

パラメーター

bEnable
[入力] TRUE 説明領域を有効にするには、説明領域を無効にする FALSE 。 既定値は TRUE です。

解説

説明領域は、プロパティ グリッド コントロールの下部に表示されます。 既定では、説明領域は無効になっており、表示されません。

CMFCPropertyGridCtrl::EnableHeaderCtrl

プロパティ グリッド コントロールの上部にあるヘッダー コントロールを有効または無効にします。

void EnableHeaderCtrl(
    BOOL bEnable=TRUE,
    LPCTSTR lpszLeftColumn=_T("Property"),
    LPCTSTR lpszRightColumn=_T("Value"));

パラメーター

bEnable
[入力] TRUE ヘッダー コントロールを有効にする場合。ヘッダー コントロールを無効にする FALSE 。 既定値は TRUE です。

lpszLeftColumn
[in]ヘッダー コントロールの左列のタイトル。 既定値は Property です。

lpszRightColumn
[in]ヘッダー コントロールの右列のタイトル。 既定値は Value です。

CMFCPropertyGridCtrl::EndEditItem

ユーザーがプロパティの変更を完了したときにフレームワークによって呼び出されます。

virtual BOOL EndEditItem(BOOL bUpdateData=TRUE);

パラメーター

bUpdateData
[入力] TRUE 編集操作が完了したときに、変更されたプロパティ データを検証する必要があることを指定する場合。それ以外の場合は FALSE。 既定値は TRUE です。

戻り値

TRUE 編集操作が正常に終了した場合。変更されたプロパティ データが有効でない場合、または編集操作を続行する必要がある場合に FALSE します。

解説

CMFCPropertyGridCtrl::EnsureVisible

プロパティ グリッド コントロールをスクロールし、指定したプロパティが表示されるまでプロパティ項目を展開します。

void EnsureVisible(
    CMFCPropertyGridProperty* pProp,
    BOOL bExpandParents=FALSE);

パラメーター

pProp
[in]プロパティへのポインター。

bExpandParents
[入力] TRUE 指定したプロパティを表示するように親項目を展開する場合。それ以外の場合は FALSE。 既定値は、FALSE です。

解説

CMFCPropertyGridCtrl::ExpandAll

すべてのプロパティ グリッド コントロール ノードを展開または折りたたみします。

void ExpandAll(BOOL bExpand=TRUE);

パラメーター

bExpand
[入力] TRUE すべてのノードを展開する。すべてのノードを折りたたむ FALSE 。 既定値は TRUE です。

解説

CMFCPropertyGridCtrl::FindItemByData

ユーザー定義の DWORD 値に関連付けられているプロパティを取得します。

CMFCPropertyGridProperty* FindItemByData(
    DWORD_PTR dwData,
    BOOL bSearchSubItems=TRUE) const;

パラメーター

dwData
[in] DWORD 値。

bSearchSubItems
[入力] TRUE プロパティサブアイテムを検索する場合。それ以外の場合は FALSE。 既定値は TRUE です。

戻り値

このメソッドが成功した場合は、関連付けられているプロパティ オブジェクトへのポインター。それ以外の場合は NULL。

解説

DWORDをプロパティに関連付けるには、CMFCPropertyGridCtrl::CMFCPropertyGridCtrlコンストラクターまたはCMFCPropertyGridProperty::SetData メソッドを使用します。

CMFCPropertyGridCtrl::get_accChildCount

virtual HRESULT get_accChildCount(long* pcountChildren);

パラメーター

[入力] pcountChildren\

戻り値

解説

CMFCPropertyGridCtrl::get_accFocus

virtual HRESULT get_accFocus(VARIANT* pvarChild);

パラメーター

[入力] pvarChild\

戻り値

解説

CMFCPropertyGridCtrl::get_accHelp

virtual HRESULT get_accHelp(
    VARIANT varChild,
    BSTR* pszHelp);

パラメーター

[入力] varChild
[入力] pszHelp\

戻り値

解説

CMFCPropertyGridCtrl::get_accHelpTopic

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

パラメーター

[入力] pszHelpFile
[入力] varChild
[入力] pidTopic\

戻り値

解説

CMFCPropertyGridCtrl::get_accKeyboardShortcut

virtual HRESULT get_accKeyboardShortcut(
    VARIANT varChild,
    BSTR* pszKeyboardShortcut);

パラメーター

[入力] varChild
[入力] pszKeyboardShortcut\

戻り値

解説

CMFCPropertyGridCtrl::get_accSelection

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

パラメーター

[入力] pvarChildren\

戻り値

解説

CMFCPropertyGridCtrl::GetBkColor

現在のプロパティ グリッド コントロールの背景色を取得します。

COLORREF GetBkColor() const;

戻り値

RGB カラー値。

解説

このメソッドは、現在のプロパティ グリッド コントロールの背景を描画するためにフレームワークが使用する色を取得します。 CMFCPropertyGridCtrl::GetTextColor メソッドは前景色を取得します。

CMFCPropertyGridCtrl::GetBoldFont

現在のプロパティ グリッド コントロールのテキストを太字で描画するために使用される Windows フォントを取得します。

CFont& GetBoldFont();

戻り値

太字フォントの特性を記述する CFont オブジェクトへの参照。

CMFCPropertyGridCtrl::GetCurSel

現在選択されているプロパティを取得します。

CMFCPropertyGridProperty* GetCurSel() const;

戻り値

プロパティ グリッド コントロールで選択した項目に対応するプロパティ オブジェクトへのポインター。

解説

CMFCPropertyGridCtrl::GetCustomColors

プロパティ グリッド コントロール要素に対して現在定義されているカスタム 色を取得します。

void GetCustomColors(
    COLORREF& clrBackground,
    COLORREF& clrText,
    COLORREF& clrGroupBackground,
    COLORREF& clrGroupText,
    COLORREF& clrDescriptionBackground,
    COLORREF& clrDescriptionText,
    COLORREF& clrLine);

パラメーター

clrBackground
[out]プロパティ値の背景色。

clrText
[out]プロパティ名とプロパティ値のテキストの色。

clrGroupBackground
[out]プロパティ グループの背景色。

clrGroupText
[out]プロパティ グループ内のテキストの色。

clrDescriptionBackground
[out]説明領域の背景色。

clrDescriptionText
[out]説明領域のテキストの色。

clrLine
[out]プロパティ間で描画される線の色。

解説

カスタム 色を設定するには、 CMFCPropertyGridCtrl::SetCustomColors メソッドを使用します。

CMFCPropertyGridCtrl::GetDescriptionHeight

プロパティ グリッド コントロールの下部にある説明領域の高さを取得します。

int GetDescriptionHeight() const;

戻り値

説明領域の高さ (ピクセル単位)。

解説

説明領域の高さは自動的に計算され、プロパティ グリッド コントロールの高さを 1/4 に設定します。

CMFCPropertyGridCtrl::EnableDescriptionAreaメソッドを使用して、説明領域を表示または非表示にします。 CMFCPropertyGridCtrl::IsDescriptionAreaメソッドを使用して、説明領域を表示するか非表示にするかを決定します。

CMFCPropertyGridCtrl::GetDescriptionRows

現在のプロパティ グリッド コントロールの説明領域内の行数を取得します。

int GetDescriptionRows() const;

戻り値

現在のプロパティ グリッド コントロールの説明領域内の行数。

解説

CMFCPropertyGridCtrl::CMFCPropertyGridCtrlコンストラクターは、説明領域を 3 行に初期化します。

CMFCPropertyGridCtrl::GetHeaderCtrl

現在のプロパティ グリッド コントロールを表示するためにフレームワークが使用する内部 CMFCHeaderCtrl オブジェクトを取得します。

virtual CMFCHeaderCtrl& GetHeaderCtrl();

戻り値

CMFCHeaderCtrl オブジェクトへの参照です。

CMFCPropertyGridCtrl::GetHeaderHeight

プロパティ グリッド コントロールのヘッダーの高さを取得します。

int GetHeaderHeight() const;

戻り値

ヘッダーの高さ (ピクセル単位)。

解説

CMFCPropertyGridCtrl::GetLeftColumnWidth

各プロパティの名前を含む、現在のプロパティ グリッド コントロールの左列の幅を取得します。

int GetLeftColumnWidth() const;

戻り値

名前列の幅。

解説

プロパティ グリッド コントロールの右側の列には、各プロパティの値が含まれています。

CMFCPropertyGridCtrl::GetListRect

プロパティ グリッド コントロールの外接する四角形を取得します。

CRect GetListRect() const;

戻り値

プロパティ グリッド コントロールの外接する四角形。 このレカンジには、説明領域とヘッダーは含まれません。

解説

CMFCPropertyGridCtrl::GetProperty

プロパティ グリッド コントロール内の項目の指定したインデックスに対応するプロパティ オブジェクトへのポインターを取得します。

CMFCPropertyGridProperty* GetProperty(int nIndex) const;

パラメーター

nIndex
[in]プロパティ グリッド コントロール項目の 0 から始まるインデックス。

このメソッドは、 nIndex パラメーターが 0 未満か、プロパティの数以上の場合にアサートします。

戻り値

このメソッドが成功した場合に、指定したインデックスに対応するプロパティ オブジェクトへのポインター。それ以外の場合は NULL。

解説

CMFCPropertyGridCtrl::GetPropertyColumnWidth

プロパティ値を含む列の現在の幅を取得します。

int GetPropertyColumnWidth() const;

戻り値

プロパティ値を含む列の現在の幅。

解説

プロパティ グリッド コントロールの右側の列には、プロパティ値が含まれています。 顧客は、プロパティ グリッド コントロールの分割ボックスを使用して、値列の幅を変更できます。

CMFCPropertyGridCtrl::GetPropertyCount

プロパティ グリッド コントロール内のプロパティの数を取得します。

int GetPropertyCount() const;

戻り値

プロパティの数。

解説

CMFCPropertyGridCtrl::GetRowHeight

プロパティ グリッド コントロール内の行の高さを取得します。

int GetRowHeight() const;

戻り値

行の高さ。

解説

行の高さは、現在のフォントの高さと 4 ピクセルに等しくなります。

CMFCPropertyGridCtrl::GetScrollBarCtrl

プロパティ グリッド コントロールのスクロール バー コントロールへのポインターを取得します。

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

パラメーター

nBar
[in] SB_VERTする必要があるスクロール バーの向き。

戻り値

スクロール バー オブジェクトへのポインター。スクロール バーがない場合、またはスクロール バーの向きがSB_HORZ場合にNULL。

解説

垂直スクロール バー コントロールに直接アクセスするには、このメソッドを使用します。

CMFCPropertyGridCtrl::GetTextColor

現在のプロパティ グリッド コントロール内のプロパティ項目のテキストを描画するために使用される色を取得します。

COLORREF GetTextColor() const;

戻り値

RGB カラー値。

解説

このメソッドは、現在のプロパティ グリッド コントロールの前景を描画するためにフレームワークが使用する色を取得します。 CMFCPropertyGridCtrl::GetBkColor メソッドは背景色を取得します。

CMFCPropertyGridCtrl::HitTest

指定したポイントがアイテム内にある場合に、プロパティ グリッド コントロール項目に対応するプロパティ オブジェクトへのポインターを取得します。 このメソッドは、ポイントを含むプロパティ グリッド コントロール内の領域も示します。

CMFCPropertyGridProperty* HitTest(
    CPoint pt,
    CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
    BOOL bPropsOnly=FALSE) const;

パラメーター

pt
[in]ポイント (クライアント座標)。

pnArea
[入力、出力] ClickArea 変数へのポインター。 このメソッドが戻るときに、変数は、指定したポイントを含む プロパティ領域 を示します。 プロパティ領域の詳細については、「解説」を参照してください。

bPropsOnly
[入力] TRUEプロパティ領域のみをテストする場合。指定したポイントがプロパティ領域にない場合は説明領域をテストするFALSE。 既定値は FALSE です。 説明領域の詳細については、「解説」を参照してください。

戻り値

bPropsOnly パラメーターがTRUEされ、指定したポイントがプロパティ領域内にある場合、戻り値は対応するプロパティ オブジェクトへのポインターです。 さらに、 pnArea パラメーターは、指定したポイントを含む特定の領域に設定されます。 それ以外の場合、戻り値は NULL され、 pnArea パラメーターは変更されません。

bPropsOnly パラメーターがFALSE場合、戻り値は常にNULL。 ただし、指定したポイントが説明領域にある場合、 pnArea パラメーターは CMFCPropertyGridProperty::ClickDescription に設定されます。

解説

プロパティ領域という用語は、プロパティ グリッド コントロール項目の名前、値、または展開ボックス領域のいずれかを指します。 説明領域は、プロパティ グリッド コントロールの下部にあるゾーンです。 プロパティ グリッド コントロール項目を選択すると、説明領域に対応するプロパティの説明が表示されます。

このメソッドは、 pnArea パラメーターが指す変数の値を設定します。 次の表に、使用可能な値と対応する領域を示します。

値	面グラフ
ClickArea::ClickExpandBox	プロパティ展開ボックス コントロール。
ClickArea::ClickName	プロパティ名。
ClickArea::ClickValue	プロパティ値。
CMFCPropertyGridProperty::ClickDescription	プロパティ グリッド コントロールの説明領域。

CMFCPropertyGridCtrl::Init

プロパティ グリッド コントロールを初期化するためにフレームワークによって呼び出されます。

virtual void Init();

解説

CMFCPropertyGridCtrl::InitHeader

現在のプロパティ グリッド コントロールを表示するためにフレームワークが使用する内部 CMFCHeaderCtrl オブジェクトを初期化します。

virtual void InitHeader();

CMFCPropertyGridCtrl::IsAlphabeticMode

プロパティ グリッド コントロールがアルファベット モードかどうかを示します。

BOOL IsAlphabeticMode() const;

戻り値

TRUE プロパティ グリッド コントロールがアルファベット モードの場合。それ以外の場合は FALSE。

解説

プロパティ グリッド コントロールがアルファベットモードの場合、すべてのプロパティは名前でアルファベット順に並べ替えられます。 それ以外の場合、プロパティは親ノードの下にグループ化されます。

CMFCPropertyGridCtrl::SetAlphabeticModeメソッドを使用して、英字モードを有効または無効にします。

CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip

BOOL IsAlwaysShowUserToolTip() const;

戻り値

解説

CMFCPropertyGridCtrl::IsDescriptionArea

プロパティ グリッド コントロールの説明領域を表示するかどうかを示します。

BOOL IsDescriptionArea() const;

戻り値

TRUE 説明領域が表示される場合。それ以外の場合は FALSE。

解説

CMFCPropertyGridCtrl::EnableDescriptionAreaメソッドを使用して、説明領域を非表示または表示します。

CMFCPropertyGridCtrl::IsGroupNameFullWidth

各プロパティ グループ名が現在のプロパティ グリッド コントロールの幅全体に表示されるかどうかを示します。

BOOL IsGroupNameFullWidth() const;

戻り値

TRUE グループ名がプロパティ グリッド コントロールの幅全体に表示される場合。グループ名がコントロールの右 (値) 列で切り捨てられている場合に FALSE します。

解説

グループは、プロパティ グリッド コントロールの関連プロパティのコレクションです。 コントロールが階層的に表示されている場合、 グループ名 はグループの上の行にカテゴリ タイトルとして表示されます。

CMFCPropertyGridCtrl::IsHeaderCtrl

ヘッダー コントロールが表示されるかどうかを示します。

BOOL IsHeaderCtrl() const;

戻り値

TRUE ヘッダー コントロールが表示される場合。それ以外の場合は FALSE。

解説

ヘッダー コントロールを非表示または表示するには、 CMFCPropertyGridCtrl::EnableHeaderCtrl メソッドを使用します。

CMFCPropertyGridCtrl::IsMarkModifiedProperties

プロパティ グリッド コントロールで変更されたプロパティを表示する方法を示します。

BOOL IsMarkModifiedProperties() const;

戻り値

TRUE 太字のスタイルを使用して変更されたプロパティを表示する場合。通常のスタイルを使用して変更されたプロパティを表示する場合に FALSE します。

解説

CMFCPropertyGridCtrl::IsShowDragContext

ユーザーが列のサイズを変更するときに、フレームワークが現在のプロパティ グリッド コントロールの名前と値の列を再描画するかどうかを示します。

BOOL IsShowDragContext() const;

戻り値

TRUE フレームワークがサイズ変更操作中に名前と値の列を再描画する場合。ドラッグ操作の完了後にフレームワークが列を再描画する場合に FALSE します。

解説

ユーザーは、列の間にある分割バーをドラッグすることで、プロパティ グリッド コントロールの名前と値の列のサイズを変更できます。 ドラッグ コンテキストが表示されている場合、ユーザーが分割バーをドラッグする限り、名前と値の列のサイズが変更されます。 それ以外の場合、分割バーは移動しますが、ドラッグ操作が完了するまで列は再描画されません。

CMFCPropertyGridCtrl::IsVSDotNetLook

プロパティ グリッド コントロールの外観が Visual Studio .NET のスタイルであるかどうかを示します。

BOOL IsVSDotNetLook() const;

戻り値

TRUE プロパティ グリッド コントロールが Visual Studio .NET のスタイルの場合。それ以外の場合は FALSE。

解説

CMFCPropertyGridCtrl::SetVSDotNetLook メソッドを使用して、プロパティ グリッド コントロールを Visual Studio .NET のスタイルに設定します。

CMFCPropertyGridCtrl::MarkModifiedProperties

変更されたプロパティを表示する方法を指定します。

void MarkModifiedProperties(
    BOOL bMark=TRUE,
    BOOL bRedraw=TRUE);

パラメーター

bMark
[入力] TRUE 変更されたプロパティを太字で表示する場合。変更されたプロパティを標準スタイルで表示 FALSE 。 既定値は TRUE です。

bRedraw
[入力] TRUE プロパティ グリッド コントロールを直ちに再描画する場合。それ以外の場合は FALSE。 既定値は TRUE です。

解説

CMFCPropertyGridCtrl::OnChangeSelection

現在の選択範囲が変更されたときにフレームワークによって呼び出されます。

virtual void OnChangeSelection(
    CMFCPropertyGridProperty* pNewSel,
    CMFCPropertyGridProperty* pOldSel);

パラメーター

pNewSel
[in]新しく選択したプロパティへのポインター。

pOldSel
[in]以前に選択したプロパティへのポインター。

解説

このメソッドの既定の実装では何も行われません。

CMFCPropertyGridCtrl::OnClickButton

プロパティ ボタンがクリックされたときにフレームワークによって呼び出されます。

virtual void OnClickButton(CPoint point);

パラメーター

point
[in]ポイント (クライアント座標)。

解説

既定では、このメソッドは現在のプロパティ値を更新します。

CMFCPropertyGridCtrl::OnDrawBorder

プロパティ グリッド コントロールの周囲に境界線を描画するためにフレームワークによって呼び出されます。

virtual void OnDrawBorder(CDC* pDC);

パラメーター

pDC
[入力] デバイス コンテキストへのポインター。

解説

CMFCPropertyGridCtrl::OnDrawDescription

説明領域を描画し、説明テキストを表示するためにフレームワークによって呼び出されます。

virtual void OnDrawDescription(
    CDC* pDC,
    CRect rect);

パラメーター

pDC
[入力] デバイス コンテキストへのポインター。

rect
[in]説明領域を描画する場所を指定する四角形。

解説

CMFCPropertyGridCtrl::EnableDescriptionAreaメソッドを使用して、説明領域を表示します。

CMFCPropertyGridCtrl::OnDrawList

プロパティ グリッド コントロール内のプロパティの一覧を表示するためにフレームワークによって呼び出されます。

virtual void OnDrawList(CDC* pDC);

パラメーター

pDC
[入力] デバイス コンテキストへのポインター。

解説

CMFCPropertyGridCtrl::OnDrawProperty

プロパティを表示するためにフレームワークによって呼び出されます。

virtual int OnDrawProperty(
    CDC* pDC,
    CMFCPropertyGridProperty* pProp) const;

パラメーター

pDC
[入力] デバイス コンテキストへのポインター。

pProp
[in]プロパティ オブジェクトへのポインター。

戻り値

TRUE このメソッドが成功した場合。それ以外の場合は FALSE。

解説

CMFCPropertyGridCtrl::OnPropertyChanged

プロパティの値が変更されたときにフレームワークによって呼び出されます。

virtual void OnPropertyChanged(CMFCPropertyGridProperty* pProp) const;

パラメーター

pProp
[in]値が変更されたプロパティ オブジェクトへのポインター。

解説

既定では、このメソッドは AFX_WM_PROPERTY_CHANGED メッセージをプロパティ グリッド コントロールの所有者に送信します。

CMFCPropertyGridCtrl::OnSelectCombo

コンボ ボックス コントロールを含むプロパティが選択されている場合に、フレームワークによって呼び出されます。

void OnSelectCombo();

解説

CMFCPropertyGridCtrl::RemoveAll

プロパティ グリッド コントロールからすべてのプロパティ オブジェクトを削除します。

void RemoveAll();

解説

CMFCPropertyGridCtrl::ResetOriginalValues

すべてのプロパティの元の値を復元します。

void ResetOriginalValues(BOOL bRedraw=TRUE);

パラメーター

bRedraw
[入力] TRUE プロパティリストを再描画する場合。それ以外の場合は FALSE。 既定値は TRUE です。

解説

CMFCPropertyGridCtrl::SetAlphabeticMode

アルファベット モードを設定またはリセットします。

void SetAlphabeticMode(BOOL bSet=TRUE);

パラメーター

bSet
[入力] TRUE アルファベットモードを設定する場合。 FALSE アルファベット モードをリセットします。 既定値は TRUE です。

解説

プロパティ グリッド コントロールがアルファベット モードの場合、コントロールは含まれるすべてのプロパティをプロパティ名で並べ替えます。

CMFCPropertyGridCtrl::SetBoolLabels

ブール型ラベルのテキストを指定します。

void SetBoolLabels(
    LPCTSTR lpszTrue,
    LPCTSTR lpszFalse);

パラメーター

lpszTrue
[in]ブール値 true に対して表示するテキスト文字列。

lpszFalse
[in]ブール値 false に対して表示するテキスト文字列。

解説

CMFCPropertyGridCtrl::SetCurSel

プロパティ グリッド コントロール内のプロパティを選択します。

void SetCurSel(
    CMFCPropertyGridProperty* pProp,
    BOOL bRedraw=TRUE);

パラメーター

pProp
[in]プロパティ オブジェクトへのポインター。

bRedraw
[入力] TRUE プロパティ グリッド コントロールを直ちに再描画する場合。それ以外の場合は FALSE。 既定値は TRUE です。

解説

プロパティ グリッド コントロールで現在の項目の選択を取り消し、指定したプロパティに対応する項目を選択するには、このメソッドを使用します。

CMFCPropertyGridCtrl::SetCustomColors

プロパティ グリッド コントロールのさまざまな要素のカスタム 色を指定します。

void SetCustomColors(
    COLORREF clrBackground,
    COLORREF clrText,
    COLORREF clrGroupBackground,
    COLORREF clrGroupText,
    COLORREF clrDescriptionBackground,
    COLORREF clrDescriptionText,
    COLORREF clrLine);

パラメーター

clrBackground
[in]プロパティ値の背景色。

clrText
[in]プロパティ名とプロパティ値のテキストの色。

clrGroupBackground
[in]プロパティ グループの背景色。

clrGroupText
[in]プロパティ グループの新しいテキストの色。

clrDescriptionBackground
[in]説明領域の背景色。

clrDescriptionText
[in]説明領域のテキストの色。

clrLine
[in]プロパティ間で描画される線の色。

解説

任意のパラメーターに対して、プロパティ グリッド コントロールの要素の既定の色を使用する ((COLORREF)-1) 色の値を指定します。

特定のプロパティの外観をカスタマイズするには、 CMFCPropertyGridProperty クラスからクラスを派生させ、 CMFCPropertyGridProperty::OnDrawName、 CMFCPropertyGridProperty::OnDrawValue、 CMFCPropertyGridProperty::OnDrawExpandBox、および CMFCPropertyGridProperty::OnDrawButton メソッドをオーバーライドします。

CMFCPropertyGridCtrl::SetDescriptionRows

現在のプロパティ グリッド コントロールの説明セクションに表示する行数を指定します。

void SetDescriptionRows(int nDescRows);

パラメーター

nDescRows
[in]プロパティの説明に表示する行数。

CMFCPropertyGridCtrl::SetGroupNameFullWidth

現在のプロパティ グリッド コントロールのプロパティ グループのカテゴリ名の全幅を表示するかどうかを指定します。

void SetGroupNameFullWidth(
    BOOL bGroupNameFullWidth = TRUE,
    BOOL bRedraw = TRUE);

パラメーター

bGroupNameFullWidth
[入力] TRUE プロパティ名列の幅に関係なく、カテゴリ名の幅全体を表示します。 FALSE : カテゴリ名の幅をプロパティ名列の幅に制限します。 既定値は TRUE です。

bRedraw
[入力] TRUE プロパティ グリッド コントロールを直ちに更新する場合。 FALSE 、次の再描画イベントが発生したときにコントロールを更新します。 既定値は TRUE です。

解説

プロパティ グリッド コントロールは、サイズ変更可能な プロパティ名 列と プロパティ値 列で構成されます。 名前列の末尾は、値列の先頭でもあります。 列のサイズを変更するには、列間の境界線をドラッグします。

グループ名とカテゴリ名という用語は、このメソッドで同じ意味で使用されます。 カテゴリ名は、関連する一連のプロパティと値を示す行に表示されます。 このメソッドは、プロパティ名列の幅にも表示されるカテゴリ名の幅を指定するかどうかを指定します。

CMFCPropertyGridCtrl::SetListDelimiter

プロパティ値の一覧で区切り記号として使用される文字を定義します。

void SetListDelimiter(TCHAR c);

パラメーター

c
[in]区切り記号として機能する文字。

解説

このメソッドを使用して、 CMFCPropertyGridProperty::CMFCPropertyGridProperty コンストラクターで使用されるプロパティ値の一覧で区切り文字を定義します。 そのコンストラクターで、 bIsValueList パラメーターを TRUE に設定します。

既定では、 CMFCPropertyGridCtrl::CMFCPropertyGridCtrl コンストラクターは区切り文字をコンマ (',') に設定します。

CMFCPropertyGridCtrl::SetShowDragContext

ユーザーが列のサイズを変更するときに、フレームワークが現在のプロパティ グリッド コントロールの名前と値の列を再描画するかどうかを指定します。

void SetShowDragContext(BOOL bShowDragContext = TRUE);

パラメーター

bShowDragContext
[入力] TRUE サイズ変更操作中に名前と値の列を再描画する場合。ドラッグ操作の完了後に列を再描画する FALSE 。 既定値は TRUE です。

解説

ユーザーは、列の間にある分割バーをドラッグすることで、プロパティ グリッド コントロールの名前と値の列のサイズを変更できます。 ドラッグ コンテキストが表示されている場合、ユーザーが分割バーをドラッグする限り、名前と値の列のサイズが変更されます。 それ以外の場合、分割バーは移動しますが、ドラッグ操作が完了するまで列は再描画されません。

CMFCPropertyGridCtrl::SetVSDotNetLook

プロパティ グリッド コントロールの外観を、Visual Studio .NET で使用されるスタイルに設定します。

void SetVSDotNetLook(BOOL bSet=TRUE);

パラメーター

bSet
[入力] TRUE プロパティ グリッド コントロールを Visual Studio .NET で使用されるスタイルに設定する場合。それ以外の場合は FALSE。 既定値は TRUE です。

解説

CMFCPropertyGridCtrl::UpdateColor

現在選択されている色プロパティの色の値を設定します。

virtual void UpdateColor(COLORREF color);

パラメーター

color
[in]RGB カラー値。

解説

プロパティ グリッド コントロールの現在選択されているプロパティがカラー プロパティでない場合、このメソッドはデバッグ モードでアサートされます。

CMFCPropertyGridCtrl::ValidateItemData

プロパティ データを検証するためにフレームワークによって呼び出されます。

virtual BOOL ValidateItemData(CMFCPropertyGridProperty* pProp);

パラメーター

pProp
[in]プロパティへのポインター。 このパラメーターは使用されません。

戻り値

常に TRUE です。

解説

CMFCPropertyGridCtrl::EndEditItem メソッドは、このメソッドを呼び出してデータを検証します。 既定では、このメソッドは pProp パラメーターを使用せず、戻り値は常に TRUE。

このメソッドをオーバーライドする場合は、指定したプロパティ データが有効な場合は、 TRUE を返します。 それ以外の場合は、 FALSEを返します。その場合、フレームワークはプロパティを更新しません。

関連項目

階層図
クラス