CMFCPropertyGridCtrl 클래스

아티클
10/12/2023

자세한 내용은 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 함수로 디스패치되기 전에 창 메시지를 번역하는 데 `DispatchMessageTranslateMessage` 사용됩니다. ( `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` 클래스	글꼴을 선택하는 데 사용되는 속성입니다.

그림

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

Property List PropertySheet.

예시

다음 예제에서는 클래스의 다양한 메서드를 사용하여 속성 그리드 컨트롤 개체를 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 수정되지 않습니다.

매개 변수인 bPropsOnlyFALSE경우 반환 값은 항상 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합니다. 이 경우 프레임워크는 속성을 업데이트하지 않습니다.

참고 항목

계층 구조 차트
클래스

다음을 통해 공유

CMFCPropertyGridCtrl 클래스

구문

멤버

공용 생성자

공용 메서드

보호된 메서드

설명

선택 속성

그림

예시

상속 계층 구조

요구 사항

CMFCPropertyGridCtrl::accSelect

매개 변수

Return Value

설명

CMFCPropertyGridCtrl::AddProperty

매개 변수

Return Value

설명

CMFCPropertyGridCtrl::AdjustLayout

설명

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

매개 변수

설명

CMFCPropertyGridCtrl::CloseColorPopup

설명

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

Return Value

설명

CMFCPropertyGridCtrl::CompareProps

매개 변수

Return Value

설명

CMFCPropertyGridCtrl::Create

매개 변수

Return Value

설명

예시

CMFCPropertyGridCtrl::DeleteProperty

매개 변수

Return Value

설명

CMFCPropertyGridCtrl::DrawControlBarColors

Return Value

설명

CMFCPropertyGridCtrl::EditItem

매개 변수

Return Value

설명

CMFCPropertyGridCtrl::EnableDescriptionArea

매개 변수

설명

CMFCPropertyGridCtrl::EnableHeaderCtrl

매개 변수

CMFCPropertyGridCtrl::EndEditItem

매개 변수

Return Value

설명

CMFCPropertyGridCtrl::EnsureVisible

매개 변수

설명

CMFCPropertyGridCtrl::ExpandAll

매개 변수

설명

CMFCPropertyGridCtrl::FindItemByData

매개 변수

Return Value

설명

CMFCPropertyGridCtrl::get_accChildCount

매개 변수

Return Value

설명

CMFCPropertyGridCtrl::get_accFocus

매개 변수

Return Value

설명

CMFCPropertyGridCtrl::get_accHelp

매개 변수

`CMFCPropertyGridCtrl::accSelect`

`CMFCPropertyGridCtrl::AddProperty`

`CMFCPropertyGridCtrl::AdjustLayout`

`CMFCPropertyGridCtrl::AlwaysShowUserToolTip`

`CMFCPropertyGridCtrl::CloseColorPopup`

`CMFCPropertyGridCtrl::CMFCPropertyGridCtrl`

`CMFCPropertyGridCtrl::CompareProps`

`CMFCPropertyGridCtrl::Create`

`CMFCPropertyGridCtrl::DeleteProperty`

`CMFCPropertyGridCtrl::DrawControlBarColors`

`CMFCPropertyGridCtrl::EditItem`

`CMFCPropertyGridCtrl::EnableDescriptionArea`

`CMFCPropertyGridCtrl::EnableHeaderCtrl`

`CMFCPropertyGridCtrl::EndEditItem`

`CMFCPropertyGridCtrl::EnsureVisible`

`CMFCPropertyGridCtrl::ExpandAll`

`CMFCPropertyGridCtrl::FindItemByData`

`CMFCPropertyGridCtrl::get_accChildCount`

`CMFCPropertyGridCtrl::get_accFocus`

`CMFCPropertyGridCtrl::get_accHelp`

`CMFCPropertyGridCtrl::get_accHelpTopic`

`CMFCPropertyGridCtrl::get_accKeyboardShortcut`

`CMFCPropertyGridCtrl::get_accSelection`

`CMFCPropertyGridCtrl::GetBkColor`

`CMFCPropertyGridCtrl::GetBoldFont`

`CMFCPropertyGridCtrl::GetCurSel`

`CMFCPropertyGridCtrl::GetCustomColors`

`CMFCPropertyGridCtrl::GetDescriptionHeight`

`CMFCPropertyGridCtrl::GetDescriptionRows`

`CMFCPropertyGridCtrl::GetHeaderCtrl`

`CMFCPropertyGridCtrl::GetHeaderHeight`

`CMFCPropertyGridCtrl::GetLeftColumnWidth`

`CMFCPropertyGridCtrl::GetListRect`

`CMFCPropertyGridCtrl::GetProperty`

`CMFCPropertyGridCtrl::GetPropertyColumnWidth`

`CMFCPropertyGridCtrl::GetPropertyCount`

`CMFCPropertyGridCtrl::GetRowHeight`

`CMFCPropertyGridCtrl::GetScrollBarCtrl`

`CMFCPropertyGridCtrl::GetTextColor`

`CMFCPropertyGridCtrl::HitTest`

`CMFCPropertyGridCtrl::Init`

`CMFCPropertyGridCtrl::InitHeader`