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 에서 Windows 함수로 디스패치되기 전에 창 메시지를 번역하는 데 DispatchMessage TranslateMessage 사용됩니다. ( 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 사용하여 목록에 속성을 추가합니다.

선택 속성

속성 항목은 값을 나타내는 대신 사용자가 색, 파일 또는 글꼴을 선택할 수 있는 대화 상자를 시작할 수 있습니다.

다음 표에는 네 가지 선택 속성 유형이 나와 있습니다.

클래스	설명
CMFCPropertyGridProperty 클래스	문자열, 부울, 날짜 등의 값을 지정하는 데 사용되는 범용 속성입니다.
CMFCPropertyGridColorProperty 클래스	색 값을 선택하는 데 사용되는 속성입니다.
CMFCPropertyGridFileProperty 클래스	파일을 선택하는 데 사용되는 속성입니다.
CMFCPropertyGridFontProperty 클래스	글꼴을 선택하는 데 사용되는 속성입니다.

그림

다음 그림에서는 두 가지 방법으로 속성을 표시하는 속성 그리드 컨트롤을 보여 줍니다. 첫 번째 그림에서는 속성을 계층적으로 표시하고 두 번째 그림은 속성을 사전순으로 표시합니다.

예시

다음 예제에서는 클래스의 다양한 메서드를 사용하여 속성 그리드 컨트롤 개체를 CMFCPropertyGridCtrl 구성하는 방법을 보여 줍니다. 이 예제에서는 헤더 컨트롤을 사용하도록 설정하고, 설명 영역을 사용하도록 설정하고, 속성 표 컨트롤의 모양을 설정하는 방법을 보여 줍니다. 또한 이 예제에서는 컨트롤이 해당 속성 이름으로 포함된 모든 속성을 정렬하는 컨트롤의 사전순 모드를 설정하는 방법과 속성 그리드 컨트롤의 다양한 요소에 대한 사용자 지정 색을 설정하는 방법을 보여 줍니다. 이 예제는 새 컨트롤 샘플의 일부입니다.

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);

매개 변수

[in] flagsSelect
[in] varChild\

Return Value

설명

CMFCPropertyGridCtrl::AddProperty

속성 그리드 컨트롤에 새 속성을 추가합니다.

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

매개 변수

pProp
[in] 속성에 대한 포인터입니다.

bRedraw
[in] TRUE 속성을 즉시 다시 그리려면 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

bAdjustLayout
[in] TRUE 속성의 텍스트와 값을 그리는 방법을 다시 계산한 다음 속성을 그립니다. FALSE 기존 계산을 사용하여 속성을 그립니다. 기본값은 TRUE입니다.

Return Value

이 메서드가 성공하면 속성이 추가되는 속성 그리드 컨트롤의 위치 인덱스(0부터 시작하는 인덱스)입니다. 그렇지 않으면 -1입니다.

설명

이 메서드는 속성 표 컨트롤의 속성 목록 끝에 지정된 속성에 대한 포인터를 추가합니다. 그리드 컨트롤이 제거되기 전에 속성을 삭제하거나 범위를 벗어나도록 허용하지 마세요. 속성 그리드 컨트롤을 완료하면 추가된 모든 속성을 삭제하도록 호출 CMFCPropertyGridCtrl::RemoveAll 합니다. 지정한 속성이 목록에 이미 추가된 경우 AddProperty 메서드가 실패합니다.

CMFCPropertyGridCtrl::AdjustLayout

속성 그리드 컨트롤과 해당 속성을 다시 그립니다.

virtual void AdjustLayout();

설명

이 메서드는 이미지, 글꼴 및 컨트롤을 포함하여 전체 속성 그리드 컨트롤 및 해당 속성을 그리는 방법을 다시 계산합니다.

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

void AlwaysShowUserToolTip(BOOL bShow = TRUE);

매개 변수

[in] bShow\

설명

CMFCPropertyGridCtrl::CloseColorPopup

색 선택 대화 상자를 닫습니다.

virtual void CloseColorPopup();

설명

색 선택 대화 상자에 대한 자세한 내용은 클래스를 참조 CMFCPropertyGridColorProperty 하세요.

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

CMFCPropertyGridCtrl 개체를 생성합니다.

CMFCPropertyGridCtrl();

Return Value

설명

CMFCPropertyGridCtrl::CompareProps

속성을 정렬하기 위해 속성 표 컨트롤에서 호출됩니다.

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

매개 변수

pProp1
속성에 대한 포인터입니다.

pProp2
속성에 대한 포인터입니다.

Return Value

반환 값	설명
< 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입니다.

Return Value

TRUE창이 성공적으로 만들어졌으면 FALSE

설명

속성 그리드 컨트롤을 만들려면 먼저 속성 그리드 개체를 생성하기 위해 호출 CMFCPropertyGridCtrl::CMFCPropertyGridCtrl 합니다. 그런 다음 CMFCPropertyGridCtrl::Create을(를) 호출합니다.

예시

다음 예제에서는 클래스에서 CMFCPropertyGridCtrl 메서드를 Create 사용 하는 방법을 보여 줍니다. 이 예제는 새 컨트롤 샘플의 일부입니다.

// 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
[in] TRUE 속성 그리드 컨트롤을 다시 그리려면 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

bAdjustLayout
[in] TRUE 속성 눈금 컨트롤에서 모든 텍스트, 이미지 및 항목을 그리는 방법을 다시 계산한 다음 컨트롤을 그립니다. 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

Return Value

TRUE이 메서드가 성공하면 이고, 그렇지 않으면 . FALSE

설명

속성 그리드 컨트롤에서 속성 및 하위 항목을 삭제하려면 이 메서드를 사용합니다.

CMFCPropertyGridCtrl::DrawControlBarColors

BOOL DrawControlBarColors() const;

Return Value

설명

CMFCPropertyGridCtrl::EditItem

사용자가 속성을 수정하기 시작할 때 프레임워크에서 호출됩니다.

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

매개 변수

pProp
[in] 속성에 대한 포인터입니다.

lptClick
[in] 사용자가 편집 작업을 시작하기 위해 클릭한 속성 표 컨트롤의 지점입니다. 지점은 컨트롤의 클라이언트 좌표에 있습니다. 기본값은 NULL입니다.

Return Value

TRUE메서드가 성공하면 이고, 그렇지 않으면 . FALSE

설명

CMFCPropertyGridCtrl::EnableDescriptionArea

속성 표 컨트롤의 속성 목록 아래에 표시되는 설명 영역을 사용하거나 사용하지 않도록 설정합니다.

void EnableDescriptionArea(BOOL bEnable=TRUE);

매개 변수

bEnable
[in] TRUE 설명 영역을 사용하도록 설정하려면 다음을 실행합니다. FALSE 설명 영역을 사용하지 않도록 설정합니다. 기본값은 TRUE입니다.

설명

설명 영역은 속성 그리드 컨트롤의 맨 아래에 표시됩니다. 기본적으로 설명 영역은 비활성화되어 표시되지 않습니다.

CMFCPropertyGridCtrl::EnableHeaderCtrl

속성 그리드 컨트롤의 맨 위에 있는 헤더 컨트롤을 사용하거나 사용하지 않도록 설정합니다.

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

매개 변수

bEnable
[in] TRUE 헤더 컨트롤을 사용하도록 설정하려면 다음을 실행합니다. FALSE 헤더 컨트롤을 사용하지 않도록 설정합니다. 기본값은 TRUE입니다.

lpszLeftColumn
[in] 헤더 컨트롤의 왼쪽 열 제목입니다. 기본값은 Property입니다.

lpszRightColumn
[in] 헤더 컨트롤의 오른쪽 열 제목입니다. 기본값은 Value입니다.

CMFCPropertyGridCtrl::EndEditItem

사용자가 속성 수정을 완료할 때 프레임워크에서 호출됩니다.

virtual BOOL EndEditItem(BOOL bUpdateData=TRUE);

매개 변수

bUpdateData
[in] TRUE 편집 작업이 완료될 때 수정된 속성 데이터의 유효성을 검사하도록 지정하려면 입니다. 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

Return Value

TRUE 편집 작업이 성공적으로 종료되면 이고, FALSE 수정된 속성 데이터가 유효하지 않거나 편집 작업을 계속해야 하는 경우

설명

CMFCPropertyGridCtrl::EnsureVisible

속성 표 컨트롤을 스크롤하고 지정된 속성이 표시될 때까지 속성 항목을 확장합니다.

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

매개 변수

pProp
[in] 속성에 대한 포인터입니다.

bExpandParents
[in] TRUE 부모 항목을 확장하여 지정된 속성을 표시하려면 그렇지 않으면 . FALSE 기본값은 FALSE입니다.

설명

CMFCPropertyGridCtrl::ExpandAll

모든 속성 그리드 컨트롤 노드를 확장하거나 축소합니다.

void ExpandAll(BOOL bExpand=TRUE);

매개 변수

bExpand
[in] TRUE 모든 노드를 확장하려면 FALSE 모든 노드를 축소합니다. 기본값은 TRUE입니다.

설명

CMFCPropertyGridCtrl::FindItemByData

사용자 정의 DWORD 값과 연결된 속성을 검색합니다.

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

매개 변수

dwData
[in] 값입니다 DWORD .

bSearchSubItems
[in] TRUE 속성 하위 항목을 검색하려면 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

Return Value

이 메서드가 성공하면 연결된 속성 개체에 대한 포인터입니다. 그렇지 않으면 . NULL

설명

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl 생성자 또는 CMFCPropertyGridProperty::SetData 메서드를 사용하여 속성과 연결 DWORD 합니다.

CMFCPropertyGridCtrl::get_accChildCount

virtual HRESULT get_accChildCount(long* pcountChildren);

매개 변수

[in] pcountChildren\

Return Value

설명

CMFCPropertyGridCtrl::get_accFocus

virtual HRESULT get_accFocus(VARIANT* pvarChild);

매개 변수

[in] pvarChild\

Return Value

설명

CMFCPropertyGridCtrl::get_accHelp

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

매개 변수

[in] varChild
[in] pszHelp\

Return Value

설명

CMFCPropertyGridCtrl::get_accHelpTopic

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

매개 변수

[in] pszHelpFile
[in] varChild
[in] pidTopic\

Return Value

설명

CMFCPropertyGridCtrl::get_accKeyboardShortcut

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

매개 변수

[in] varChild
[in] pszKeyboardShortcut\

Return Value

설명

CMFCPropertyGridCtrl::get_accSelection

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

매개 변수

[in] pvarChildren\

Return Value

설명

CMFCPropertyGridCtrl::GetBkColor

현재 속성 그리드 컨트롤의 배경색을 검색합니다.

COLORREF GetBkColor() const;

Return Value

RGB 색 값입니다.

설명

이 메서드는 프레임워크가 현재 속성 그리드 컨트롤의 배경을 그리는 데 사용하는 색을 검색합니다. 메서드는 CMFCPropertyGridCtrl::GetTextColor 전경색을 검색합니다.

CMFCPropertyGridCtrl::GetBoldFont

현재 속성 표 컨트롤의 텍스트를 굵은 스타일로 그리는 데 사용되는 Windows 글꼴을 검색합니다.

CFont& GetBoldFont();

Return Value

굵은 CFont 글꼴의 특성을 설명하는 개체에 대한 참조입니다.

CMFCPropertyGridCtrl::GetCurSel

현재 선택한 속성을 검색합니다.

CMFCPropertyGridProperty* GetCurSel() const;

Return Value

속성 표 컨트롤에서 선택한 항목에 해당하는 속성 개체에 대한 포인터입니다.

설명

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;

Return Value

설명 영역의 높이(픽셀)입니다.

설명

설명 영역의 높이는 자동으로 계산되며 속성 그리드 컨트롤의 높이인 1/4로 설정됩니다.

메서드를 CMFCPropertyGridCtrl::EnableDescriptionArea 사용하여 설명 영역을 표시하거나 숨깁니다. 이 메서드를 CMFCPropertyGridCtrl::IsDescriptionArea 사용하여 설명 영역이 표시되는지 숨겨지는지 여부를 확인합니다.

CMFCPropertyGridCtrl::GetDescriptionRows

현재 속성 그리드 컨트롤의 설명 영역에서 행 수를 검색합니다.

int GetDescriptionRows() const;

Return Value

현재 속성 표 컨트롤의 설명 영역에 있는 행 수입니다.

설명

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl 생성자는 설명 영역을 3개의 행으로 초기화합니다.

CMFCPropertyGridCtrl::GetHeaderCtrl

프레임워크에서 현재 속성 그리드 컨트롤을 표시하는 데 사용하는 내부 CMFCHeaderCtrl 개체를 검색합니다.

virtual CMFCHeaderCtrl& GetHeaderCtrl();

Return Value

CMFCHeaderCtrl 개체에 대한 참조입니다.

CMFCPropertyGridCtrl::GetHeaderHeight

속성 그리드 컨트롤의 헤더 높이를 검색합니다.

int GetHeaderHeight() const;

Return Value

머리글의 높이(픽셀)입니다.

설명

CMFCPropertyGridCtrl::GetLeftColumnWidth

각 속성의 이름을 포함하는 현재 속성 그리드 컨트롤의 왼쪽 열 너비를 검색합니다.

int GetLeftColumnWidth() const;

Return Value

이름 열의 너비입니다.

설명

속성 그리드 컨트롤의 오른쪽 열에는 각 속성의 값이 포함됩니다.

CMFCPropertyGridCtrl::GetListRect

속성 그리드 컨트롤의 경계 사각형을 검색합니다.

CRect GetListRect() const;

Return Value

속성 그리드 컨트롤의 경계 사각형입니다. 이 사각형에는 설명 영역과 헤더가 포함되지 않습니다.

설명

CMFCPropertyGridCtrl::GetProperty

속성 표 컨트롤에서 항목의 지정된 인덱스에 해당하는 속성 개체에 대한 포인터를 검색합니다.

CMFCPropertyGridProperty* GetProperty(int nIndex) const;

매개 변수

nIndex
[in] 속성 그리드 컨트롤 항목의 인덱스(0부터 시작하는 인덱스)입니다.

이 메서드는 매개 변수가 nIndex 0보다 작거나 속성 수보다 크거나 같은 경우 어설션합니다.

Return Value

이 메서드가 성공하면 지정된 인덱스에 해당하는 속성 개체에 대한 포인터입니다. 그렇지 않으면 . NULL

설명

CMFCPropertyGridCtrl::GetPropertyColumnWidth

속성 값이 포함된 열의 현재 너비를 검색합니다.

int GetPropertyColumnWidth() const;

Return Value

속성 값이 포함된 열의 현재 너비입니다.

설명

속성 그리드 컨트롤의 오른쪽 열에는 속성 값이 포함됩니다. 고객은 속성 그리드 컨트롤의 분할 상자를 사용하여 값 열의 너비를 변경할 수 있습니다.

CMFCPropertyGridCtrl::GetPropertyCount

속성 그리드 컨트롤의 속성 수를 검색합니다.

int GetPropertyCount() const;

Return Value

속성 수입니다.

설명

CMFCPropertyGridCtrl::GetRowHeight

속성 그리드 컨트롤에서 행의 높이를 검색합니다.

int GetRowHeight() const;

Return Value

행의 높이입니다.

설명

행의 높이는 현재 글꼴 높이와 4픽셀을 더한 값과 같습니다.

CMFCPropertyGridCtrl::GetScrollBarCtrl

속성 표 컨트롤의 스크롤 막대 컨트롤에 대한 포인터를 검색합니다.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

매개 변수

nBar
[in] 스크롤 막대 SB_VERT의 방향입니다.

Return Value

스크롤 막대 개체에 대한 포인터이거나 NULL 스크롤 막대가 없거나 스크롤 막대 방향이 있는 경우 .SB_HORZ

설명

이 메서드를 사용하여 세로 스크롤 막대 컨트롤에 직접 액세스할 수 있습니다.

CMFCPropertyGridCtrl::GetTextColor

현재 속성 표 컨트롤에서 속성 항목의 텍스트를 그리는 데 사용되는 색을 검색합니다.

COLORREF GetTextColor() const;

Return Value

RGB 색 값입니다.

설명

이 메서드는 프레임워크가 현재 속성 그리드 컨트롤의 전경을 그리는 데 사용하는 색을 검색합니다. 메서드는 CMFCPropertyGridCtrl::GetBkColor 배경색을 검색합니다.

CMFCPropertyGridCtrl::HitTest

지정된 점이 항목에 있는 경우 속성 그리드 컨트롤 항목에 해당하는 속성 개체에 대한 포인터를 검색합니다. 또한 이 메서드는 점을 포함하는 속성 그리드 컨트롤의 영역을 나타냅니다.

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

매개 변수

pt
[in] 클라이언트 좌표의 점입니다.

pnArea
[in, out] 변수에 대한 포인터입니다 ClickArea . 이 메서드가 반환될 때 변수는 지정된 점을 포함하는 속성 영역을 나타냅니다. 속성 영역에 대한 자세한 내용은 비고를 참조하세요.

bPropsOnly
[in] TRUE 속성 영역만 테스트하려면 FALSE 지정된 점이 속성 영역에 없는 경우 설명 영역을 테스트합니다. 기본값은 FALSE입니다. 설명 영역에 대한 자세한 내용은 비고를 참조하세요.

Return Value

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;

Return Value

TRUE 속성 그리드 컨트롤이 사전순 모드인 경우 그렇지 않으면 FALSE.

설명

속성 그리드 컨트롤이 사전순 모드인 경우 모든 속성은 이름을 기준으로 사전순으로 정렬됩니다. 그렇지 않으면 속성이 부모 노드 아래에 그룹화됩니다.

이 메서드를 CMFCPropertyGridCtrl::SetAlphabeticMode 사용하여 사전순 모드를 사용하거나 사용하지 않도록 설정합니다.

CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip

BOOL IsAlwaysShowUserToolTip() const;

Return Value

설명

CMFCPropertyGridCtrl::IsDescriptionArea

속성 그리드 컨트롤의 설명 영역이 표시되는지 여부를 나타냅니다.

BOOL IsDescriptionArea() const;

Return Value

TRUE설명 영역이 표시되면 이고, 그렇지 않으면 . FALSE

설명

메서드를 CMFCPropertyGridCtrl::EnableDescriptionArea 사용하여 설명 영역을 숨기거나 표시합니다.

CMFCPropertyGridCtrl::IsGroupNameFullWidth

각 속성 그룹 이름이 현재 속성 그리드 컨트롤의 너비에 걸쳐 표시되는지 여부를 나타냅니다.

BOOL IsGroupNameFullWidth() const;

Return Value

TRUE 속성 표 컨트롤의 너비에 그룹 이름이 표시되면 이고, FALSE 그룹 이름이 컨트롤의 오른쪽(값) 열로 잘리면 입니다.

설명

그룹은 속성 그리드 컨트롤의 관련 속성 컬렉션입니다. 컨트롤이 계층적으로 표시되는 경우 그룹 이름은 그룹 위의 행에 범주 제목으로 표시됩니다.

CMFCPropertyGridCtrl::IsHeaderCtrl

헤더 컨트롤이 표시되는지 여부를 나타냅니다.

BOOL IsHeaderCtrl() const;

Return Value

TRUE 헤더 컨트롤이 표시되면 이고, 그렇지 않으면 FALSE.

설명

메서드를 CMFCPropertyGridCtrl::EnableHeaderCtrl 사용하여 헤더 컨트롤을 숨기거나 표시합니다.

CMFCPropertyGridCtrl::IsMarkModifiedProperties

속성 표 컨트롤이 수정된 속성을 표시하는 방법을 나타냅니다.

BOOL IsMarkModifiedProperties() const;

Return Value

TRUE 굵게 스타일을 사용하여 수정된 속성을 표시하면 이고, FALSE 수정된 속성을 표시하는 데 일반 스타일을 사용하는 경우

설명

CMFCPropertyGridCtrl::IsShowDragContext

사용자가 열의 크기를 조정할 때 프레임워크가 현재 속성 그리드 컨트롤의 이름 및 값 열을 다시 그릴지 여부를 나타냅니다.

BOOL IsShowDragContext() const;

Return Value

TRUE 크기 조정 작업 중에 프레임워크가 이름 및 값 열을 다시 그리면 이고, FALSE 끌어서 끌기 작업이 완료된 후 프레임워크가 열을 다시 그리면 입니다.

설명

사용자는 열 사이에 있는 분할 막대를 끌어 속성 그리드 컨트롤의 이름 및 값 열의 크기를 조정할 수 있습니다. 끌기 컨텍스트가 표시되면 사용자가 분할 막대를 끌면 이름과 값 열의 크기가 조정됩니다. 그렇지 않으면 분할 막대가 이동하지만 끌기 작업이 완료될 때까지 열이 다시 그려지지 않습니다.

CMFCPropertyGridCtrl::IsVSDotNetLook

속성 그리드 컨트롤의 모양이 Visual Studio .NET 스타일인지 여부를 나타냅니다.

BOOL IsVSDotNetLook() const;

Return Value

TRUE속성 그리드 컨트롤이 Visual Studio .NET 스타일이면 이고, 그렇지 않으면 . FALSE

설명

이 메서드를 CMFCPropertyGridCtrl::SetVSDotNetLook 사용하여 속성 그리드 컨트롤을 Visual Studio .NET 스타일로 설정합니다.

CMFCPropertyGridCtrl::MarkModifiedProperties

수정된 속성을 표시하는 방법을 지정합니다.

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

매개 변수

bMark
[in] TRUE 수정된 속성을 굵은 스타일로 표시하려면 FALSE 수정된 속성을 일반 스타일로 표시합니다. 기본값은 TRUE입니다.

bRedraw
[in] 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
[in] 디바이스 컨텍스트에 대한 포인터입니다.

설명

CMFCPropertyGridCtrl::OnDrawDescription

프레임워크에서 설명 영역을 그리고 설명 텍스트를 표시하기 위해 호출됩니다.

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

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

rect
[in] 설명 영역을 그릴 위치를 지정하는 사각형입니다.

설명

메서드를 CMFCPropertyGridCtrl::EnableDescriptionArea 사용하여 설명 영역을 표시합니다.

CMFCPropertyGridCtrl::OnDrawList

속성 그리드 컨트롤의 속성 목록을 표시하기 위해 프레임워크에서 호출됩니다.

virtual void OnDrawList(CDC* pDC);

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

설명

CMFCPropertyGridCtrl::OnDrawProperty

속성을 표시하기 위해 프레임워크에서 호출됩니다.

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

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

pProp
[in] 속성 개체에 대한 포인터입니다.

Return Value

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
[in] TRUE 속성 목록을 다시 그리려면 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

설명

CMFCPropertyGridCtrl::SetAlphabeticMode

사전순 모드를 설정하거나 다시 설정합니다.

void SetAlphabeticMode(BOOL bSet=TRUE);

매개 변수

bSet
[in] 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
[in] 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::OnDrawValue, CMFCPropertyGridProperty::OnDrawExpandBox및 CMFCPropertyGridProperty::OnDrawButton 메서드를 재정의CMFCPropertyGridProperty::OnDrawName합니다.

CMFCPropertyGridCtrl::SetDescriptionRows

현재 속성 그리드 컨트롤의 설명 섹션에 표시할 행 수를 지정합니다.

void SetDescriptionRows(int nDescRows);

매개 변수

nDescRows
[in] 속성 설명에 표시할 행 수입니다.

CMFCPropertyGridCtrl::SetGroupNameFullWidth

현재 속성 표 컨트롤의 속성 그룹에 대한 범주 이름의 전체 너비를 표시할지 여부를 지정합니다.

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

매개 변수

bGroupNameFullWidth
[in] TRUE 속성 이름 열의 너비에 관계없이 범주 이름의 전체 너비를 표시합니다. FALSE 범주 이름의 너비를 속성 이름 열의 너비로 제한합니다. 기본값은 TRUE입니다.

bRedraw
[in] 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
[in] TRUE 크기 조정 작업 중에 이름 및 값 열을 다시 그리려면 FALSE 끌기 작업이 완료된 후 열을 다시 그리려면 입니다. 기본값은 TRUE입니다.

설명

사용자는 열 사이에 있는 분할 막대를 끌어 속성 그리드 컨트롤의 이름 및 값 열의 크기를 조정할 수 있습니다. 끌기 컨텍스트가 표시되면 사용자가 분할 막대를 끌면 이름과 값 열의 크기가 조정됩니다. 그렇지 않으면 분할 막대가 이동하지만 끌기 작업이 완료될 때까지 열이 다시 그려지지 않습니다.

CMFCPropertyGridCtrl::SetVSDotNetLook

속성 그리드 컨트롤의 모양을 Visual Studio .NET에서 사용되는 스타일로 설정합니다.

void SetVSDotNetLook(BOOL bSet=TRUE);

매개 변수

bSet
[in] 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] 속성에 대한 포인터입니다. 이 매개 변수는 사용되지 않습니다.

Return Value

항상 TRUE입니다.

설명

메서드는 CMFCPropertyGridCtrl::EndEditItem 이 메서드를 호출하여 데이터의 유효성을 검사합니다. 기본적으로 이 메서드는 해당 매개 변수를 pProp 사용하지 않으며 반환 값은 항상 TRUE입니다.

이 메서드를 재정의하는 경우 지정된 속성 데이터가 유효한지 반환 TRUE 합니다. 그렇지 않으면 반환 FALSE합니다. 이 경우 프레임워크는 속성을 업데이트하지 않습니다.

참고 항목

계층 구조 차트
클래스