다음을 통해 공유


CMFCPropertyGridProperty 클래스

CMFCPropertyGridProperty 개체는 속성 목록 컨트롤의 목록 항목을 나타냅니다.

자세한 내용은 Visual Studio 설치의 mfc 폴더에 있는 소스 코드를 참조하세요. 예들 들어 %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc입니다.

구문

class CMFCPropertyGridProperty : public CObject

멤버

공용 생성자

속성 설명
CMFCPropertyGridProperty::CMFCPropertyGridProperty CMFCPropertyGridProperty 개체를 생성합니다.
CMFCPropertyGridProperty::~CMFCPropertyGridProperty 소멸자

공용 메서드

이름 설명
CMFCPropertyGridProperty::AddOption 속성 목록 컨트롤에 새 목록 항목을 추가합니다.
CMFCPropertyGridProperty::AddSubItem 속성에 자식 항목을 추가합니다.
CMFCPropertyGridProperty::AdjustButtonRect 포함된 단추의 경계 사각형 크기를 조정하도록 속성에 알리기 위해 부모 속성 목록 컨트롤에서 호출됩니다.
CMFCPropertyGridProperty::AdjustInPlaceEditRect 속성 값을 설정하는 데 사용되는 텍스트 상자 및 선택적 스핀 단추 컨트롤의 경계를 검색합니다.
CMFCPropertyGridProperty::AllowEdit 속성을 편집 가능하거나 읽기 전용으로 만듭니다.
CMFCPropertyGridProperty::CreateInPlaceEdit 속성에 대한 편집 가능한 컨트롤을 만들기 위해 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::CreateSpinControl 편집 가능한 스핀 단추 컨트롤을 만들기 위해 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::Enable 속성을 사용하거나 사용하지 않도록 설정합니다.
CMFCPropertyGridProperty::EnableSpinControl 속성 값을 수정하는 데 사용되는 스핀 단추 컨트롤을 사용하거나 사용하지 않도록 설정합니다.
CMFCPropertyGridProperty::Expand 하위 속성이 포함된 속성을 확장하거나 축소합니다.
CMFCPropertyGridProperty::FormatProperty 속성 값의 텍스트 표현에 서식을 지정합니다.
CMFCPropertyGridProperty::GetData 속성과 연결된 DWORD 값을 검색합니다.
CMFCPropertyGridProperty::GetDescription 속성 설명을 검색합니다.
CMFCPropertyGridProperty::GetExpandedSubItems 확장된 하위 항목의 수를 검색합니다.
CMFCPropertyGridProperty::GetHierarchyLevel 속성 계층 수준의 인덱스(0부터 시작하는 인덱스)를 검색합니다.
CMFCPropertyGridProperty::GetName 속성의 이름을 검색합니다.
CMFCPropertyGridProperty::GetNameTooltip 도구 설명에 속성의 이름을 표시하기 위해 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::GetOption 인덱스로 지정된 옵션의 텍스트를 검색합니다.
CMFCPropertyGridProperty::GetOptionCount 속성에 속하는 옵션 수를 검색합니다.
CMFCPropertyGridProperty::GetOriginalValue 현재 속성의 초기 값을 검색합니다.
CMFCPropertyGridProperty::GetParent 부모 속성에 대한 포인터를 검색합니다.
CMFCPropertyGridProperty::GetRect 속성의 경계 사각형을 검색합니다.
CMFCPropertyGridProperty::GetSubItem 0부터 시작하는 인덱스로 식별되는 하위 프로퍼티를 검색합니다.
CMFCPropertyGridProperty::GetSubItemsCount 하위 항목 수를 검색합니다.
CMFCPropertyGridProperty::GetThisClass 프레임워크에서 이 클래스 형식과 연결된 개체에 CRuntimeClass 대한 포인터를 가져오는 데 사용됩니다.
CMFCPropertyGridProperty::GetValue 속성 값을 검색합니다.
CMFCPropertyGridProperty::GetValueTooltip 프레임워크에서 호출하여 도구 설명에 표시되는 속성 값의 텍스트 표현을 검색합니다.
CMFCPropertyGridProperty::HitTest 지점에 해당하는 속성 목록 항목에 해당하는 속성 개체를 가리킵니다.
CMFCPropertyGridProperty::IsAllowEdit 속성을 편집할 수 있는지 여부를 나타냅니다.
CMFCPropertyGridProperty::IsEnabled 속성을 사용할지 여부를 나타냅니다.
CMFCPropertyGridProperty::IsExpanded 속성이 확장 또는 축소되는지 여부를 나타냅니다.
CMFCPropertyGridProperty::IsGroup 현재 속성이 그룹을 나타내는지 여부를 나타냅니다.
CMFCPropertyGridProperty::IsInPlaceEditing 현재 속성을 편집할 수 있는지 여부를 나타냅니다.
CMFCPropertyGridProperty::IsModified 현재 속성이 수정되었는지 여부를 나타냅니다.
CMFCPropertyGridProperty::IsParentExpanded 현재 속성의 부모가 확장되는지 여부를 나타냅니다.
CMFCPropertyGridProperty::IsSelected 현재 속성이 선택되어 있는지 여부를 나타냅니다.
CMFCPropertyGridProperty::IsVisible 현재 속성이 표시되는지 여부를 나타냅니다.
CMFCPropertyGridProperty::OnClickButton 사용자가 속성에 포함된 단추를 선택할 때 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnClickName 사용자가 속성의 이름 필드를 선택할 때 부모 속성 목록 컨트롤에서 호출됩니다.
CMFCPropertyGridProperty::OnClickValue 사용자가 속성의 값 필드를 선택할 때 부모 속성 목록 컨트롤에서 호출됩니다.
CMFCPropertyGridProperty::OnCloseCombo 속성에 포함된 콤보 상자를 닫을 때 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnDblClk 사용자가 속성을 두 번 클릭할 때 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnDrawButton 속성에 포함된 단추를 그리기 위해 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnDrawDescription 속성 설명을 표시하기 위해 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnDrawExpandBox 하위 속성이 포함된 속성 근처에 확장 상자 컨트롤을 그리기 위해 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnDrawName 속성 이름을 표시하기 위해 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnDrawValue 속성 값을 표시하기 위해 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnEdit 사용자가 속성 값을 수정하려고 할 때 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnEndEdit 사용자가 속성 값 수정을 마쳤을 때 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnKillSelection
CMFCPropertyGridProperty::OnPosSizeChanged
CMFCPropertyGridProperty::OnRClickName 사용자가 속성 이름 영역에서 마우스 오른쪽 단추를 선택할 때 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnRClickValue 사용자가 속성 값 영역에서 마우스 오른쪽 단추를 선택할 때 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnSelectCombo 사용자가 편집 가능한 콤보 상자에서 항목을 선택할 때 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnSetCursor 마우스 포인터가 속성 항목으로 이동할 때 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnSetSelection
CMFCPropertyGridProperty::OnUpdateValue 편집 가능한 속성 값이 변경되었을 때 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::PushChar 속성이 선택되고 사용자가 새 문자를 입력할 때 속성 목록 컨트롤에서 호출됩니다.
CMFCPropertyGridProperty::Redraw 속성을 다시 그어 줍니다.
CMFCPropertyGridProperty::RemoveAllOptions 속성에서 모든 옵션(항목)을 제거합니다.
CMFCPropertyGridProperty::RemoveSubItem 지정된 하위 사이트를 제거합니다.
CMFCPropertyGridProperty::ResetOriginalValue 편집된 속성의 원래 값을 복원합니다.
CMFCPropertyGridProperty::SetData DWORD 값을 속성과 연결합니다.
CMFCPropertyGridProperty::SetDescription 현재 속성을 설명하는 텍스트를 지정합니다.
CMFCPropertyGridProperty::SetName 속성의 이름을 설정합니다.
CMFCPropertyGridProperty::SetOriginalValue 편집 가능한 속성의 원래 값을 설정합니다.
CMFCPropertyGridProperty::SetValue 속성 표 속성의 값을 설정합니다.
CMFCPropertyGridProperty::Show 속성을 표시하거나 숨깁니다.

보호된 메서드

속성 설명
CMFCPropertyGridProperty::CreateCombo 속성에 콤보 상자를 추가하기 위해 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::HasButton 속성에 단추가 포함되어 있는지 여부를 나타냅니다.
CMFCPropertyGridProperty::Init 속성 개체를 초기화하기 위해 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::IsSubItem 지정된 속성이 현재 속성의 하위 항목인지 여부를 나타냅니다.
CMFCPropertyGridProperty::IsValueChanged 현재 속성의 값이 변경되었는지 여부를 나타냅니다.
CMFCPropertyGridProperty::OnCtlColor 속성의 배경색을 채우기 위해 브러시를 검색해야 하는 경우 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnDestroyWindow 속성이 제거되거나 편집이 완료되면 프레임워크에서 호출됩니다.
CMFCPropertyGridProperty::OnKillFocus 속성이 입력 포커스를 잃을 때 프레임워크에서 호출됩니다.

데이터 멤버

속성 설명
CMFCPropertyGridProperty::m_strFormatDouble double 형식의 값에 대한 형식 문자열입니다.
CMFCPropertyGridProperty::m_strFormatFloat float 형식의 값에 대한 형식 문자열입니다.
CMFCPropertyGridProperty::m_strFormatLong long 형식의 값에 대한 형식 문자열입니다.
CMFCPropertyGridProperty::m_strFormatShort 짧은 형식의 값에 대한 형식 문자열입니다.

설명

개체를 CMFCPropertyGridProperty 사용하여 속성을 표시한 다음 속성 목록 컨트롤에 추가합니다. 자세한 내용은 클래스를 참조 CMFCPropertyGridCtrl 하세요.

속성 개체는 문자열, 날짜, 부울 또는 정수 값과 같은 데이터 형식을 나타낼 수 있습니다. 자식 속성을 포함하거나 콤보 상자 또는 단추 컨트롤과 같은 컨트롤을 포함할 수 있습니다.

예시

다음 예제에서는 개체를 생성하는 CMFCPropertyGridProperty 방법을 보여 줍니다. 또한 이 예제에서는 클래스의 CMFCPropertyGridProperty 다양한 메서드를 사용하여 옵션을 추가하고, 하위 항목을 추가하고, 속성을 사용하도록 설정하고, 속성을 표시하는 방법을 보여 줍니다. 이 예제는 새 컨트롤 샘플일부입니다.

CMFCPropertyGridProperty *pGroup1 = new CMFCPropertyGridProperty(_T("Appearance"));

// construct a COleVariant object.
COleVariant var3DLook((short)VARIANT_FALSE, VT_BOOL);

pGroup1->AddSubItem(new CMFCPropertyGridProperty(_T("3D Look"), var3DLook,
                                                 _T("Specifies the dialog's font will be nonbold and controls will have a 3D border")));

CMFCPropertyGridProperty *pProp = new CMFCPropertyGridProperty(_T("Border"),
                                                               _T("Dialog Frame"), _T("One of: None, Thin, Resizable, or Dialog Frame"));
pProp->AddOption(_T("None"));
pProp->AddOption(_T("Thin"));
pProp->AddOption(_T("Resizable"));
pProp->AddOption(_T("Dialog Frame"));
pProp->AllowEdit(FALSE);

pGroup1->AddSubItem(pProp);
pGroup1->AddSubItem(new CMFCPropertyGridProperty(_T("Caption"), (COleVariant) _T("About NewControlsDemo"), _T("Specifies the text that will be displayed in the dialog's title bar")));
pGroup1->AdjustButtonRect();
pGroup1->AllowEdit();
pGroup1->Enable();
pGroup1->Show();
pGroup1->Redraw();

상속 계층 구조

CObject

CMFCPropertyGridProperty

요구 사항

머리글: afxpropertygridctrl.h

CMFCPropertyGridProperty::AddOption

속성 목록 컨트롤에 새 목록 항목을 추가합니다.

BOOL AddOption(
    LPCTSTR lpszOption,
    BOOL bInsertUnique=TRUE);

매개 변수

lpszOption
[in] 추가할 목록 항목(옵션)입니다.

bInsertUnique
[in] TRUE 목록 항목이 아직 없는 경우에만 추가하려면 입니다. 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

Return Value

TRUE- 목록 항목이 추가됨을 의미합니다. 그렇지 않으면 FALSE매개 변수가 있고 매개 변수 TRUE 에 지정된 lpszOption 목록 항목이 이미 있으므로 bInsertUnique 목록 항목이 추가되지 않습니다.

CMFCPropertyGridProperty::AddSubItem

속성에 자식 항목을 추가합니다.

BOOL AddSubItem(CMFCPropertyGridProperty* pProp);

매개 변수

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

Return Value

TRUE 지정된 속성이 자식 속성으로 성공적으로 추가되면 입니다. FALSE 부모 속성에서 이미 발생하므로 속성이 추가되지 않으면 입니다.

설명

이 메서드를 사용하여 부모 및 자식 속성의 계층적 목록을 만듭니다. 자식 속성이 추가되면 부모 속성은 더하기 기호(+)로 지정된 확장 상자 컨트롤을 자동으로 표시합니다. 사용자가 더하기 기호를 선택하면 부모 속성이 확장되고 자식 속성 항목이 표시됩니다.

CMFCPropertyGridProperty::AdjustButtonRect

포함된 단추의 경계 사각형 크기를 조정하도록 속성에 알리기 위해 부모 속성 목록 컨트롤에서 호출됩니다.

virtual void AdjustButtonRect();

설명

기본적으로 이 메서드는 다음과 같습니다.

  • 단추의 너비를 단추 높이와 3픽셀을 더한 값으로 조정합니다.
  • 단추의 경계 사각형을 속성의 오른쪽 가장자리로 이동합니다.
  • 단추를 속성의 위쪽 가장자리 아래로 1픽셀 이동합니다.

CMFCPropertyGridProperty::AdjustInPlaceEditRect

속성 값을 설정하는 데 사용되는 텍스트 상자 및 선택적 스핀 단추 컨트롤의 경계를 검색합니다.

virtual void AdjustInPlaceEditRect(
    CRect& rectEdit,
    CRect& rectSpin);

매개 변수

rectEdit
[out] 이 메서드가 반환되면 속성 값에 대한 텍스트 상자의 경계를 지정하는 사각형입니다.

rectSpin
[out] 이 메서드가 반환되면 속성 값에 대한 스핀 단추 컨트롤의 경계를 지정하는 사각형입니다. 또는 속성이 스핀 단추를 지원하지 않는 경우 빈 사각형입니다.

설명

속성의 값 영역은 텍스트 상자와 스핀 단추 컨트롤과 같은 옵션 단추로 구성됩니다. 이 메서드는 텍스트 상자 및 옵션 단추의 차원을 계산한 다음 지정된 매개 변수에서 해당 값을 반환합니다.

CMFCPropertyGridProperty::AllowEdit

속성을 편집 가능하거나 읽기 전용으로 만듭니다.

void AllowEdit(BOOL bAllow=TRUE);

매개 변수

bAllow
[in] TRUE 속성을 편집할 수 있도록 하려면 다음을 실행합니다. FALSE 속성을 읽기 전용으로 만듭니다. 기본값은 TRUE입니다.

CMFCPropertyGridProperty::CMFCPropertyGridProperty

CMFCPropertyGridProperty 개체를 생성합니다.

CMFCPropertyGridProperty(
    const CString& strGroupName,
    DWORD_PTR dwData=0,
    BOOL bIsValueList=FALSE);

CMFCPropertyGridProperty(
    const CString& strName,
    const _variant_t& varValue,
    LPCTSTR lpszDescr=NULL,
    DWORD_PTR dwData=0,
    LPCTSTR lpszEditMask=NULL,
    LPCTSTR lpszEditTemplate=NULL,
    LPCTSTR lpszValidChars=NULL);

매개 변수

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

dwData
[in] 정수 또는 속성과 연결된 다른 데이터에 대한 포인터와 같은 애플리케이션별 데이터입니다. 기본값은 0입니다.

strName
[in] 속성의 이름입니다.

varValue
[in] 속성 값입니다.

lpszDescr
[in] 속성 설명입니다. 기본값은 NULL입니다.

lpszEditMask
[in] 속성이 마스킹된 편집 컨트롤인 경우 편집 마스크입니다. 기본값은 NULL입니다.

lpszEditTemplate
[in] 속성이 마스킹된 편집 컨트롤인 경우 편집 템플릿입니다. 기본값은 NULL입니다.

lpszValidChars
[in] 속성이 마스킹된 편집 컨트롤인 경우 유효한 문자 목록입니다. 기본값은 NULL입니다.

bIsValueList
[in] TRUE 속성이 값 목록을 나타내면 이고, FALSE 속성이 단일 값을 나타내는 경우 기본값은 FALSE입니다.

CMFCPropertyGridProperty::CreateCombo

속성에 콤보 상자를 추가하기 위해 프레임워크에서 호출됩니다.

virtual CComboBox* CreateCombo(
    CWnd* pWndParent,
    CRect rect);

매개 변수

pWndParent
[in] 콤보 상자의 부모 창에 대한 포인터입니다.

rect
[in] 콤보 상자의 경계 사각형입니다.

Return Value

CComboBox 개체에 대한 포인터입니다.

CMFCPropertyGridProperty::CreateInPlaceEdit

속성에 대한 편집 가능한 컨트롤을 만들기 위해 프레임워크에서 호출됩니다.

virtual CWnd* CreateInPlaceEdit(
    CRect rectEdit,
    BOOL& bDefaultFormat);

매개 변수

rectEdit
[in] 편집 가능한 컨트롤의 경계 사각형입니다.

bDefaultFormat
[in] TRUE 기본 속성 형식을 사용하여 편집 가능한 컨트롤의 텍스트를 설정하려면 입니다. 그렇지 않으면 . FALSE

Return Value

이 메서드가 성공하면 편집 가능한 컨트롤에 대한 포인터입니다. 그렇지 않으면 . NULL

설명

이 메서드는 클래스 생성자에 지정된 , lpszEditMasklpszEditTemplatelpszValidChars 매개 변수의 CMFCPropertyGridProperty 값을 varValue사용합니다. 기본적으로 이 메서드는 변형 형식을 varValue 지원합니다. 여기에는 , VT_R4,, VT_R8,VT_UI1VT_I2, VT_INT, VT_UINT, VT_UI2VT_I4VT_UI4및 .가 포함됩니다.VT_BSTRVT_BOOL

이 메서드는 CMFCMaskedEdit 하나 이상의 매개 변수 또는 lpszValidChars 매개 변수가 lpszEditMasklpszEditTemplate지정된 경우 컨트롤을 만들고, 그렇지 않으면 컨트롤을 CEdit 만듭니다.

CMFCPropertyGridProperty::CreateSpinControl

편집 가능한 스핀 단추 컨트롤을 만들기 위해 프레임워크에서 호출됩니다.

virtual CSpinButtonCtrl* CreateSpinControl(CRect rectSpin);

매개 변수

rectSpin
[in] 편집 가능한 스핀 단추 컨트롤이 만들어지는 위치를 정의하는 사각형입니다.

Return Value

개체에 대한 포인터로 캐스팅되는 새 CMFCSpinButtonCtrl 개체에 대한 포인터입니다 CSpinButtonCtrl .

설명

메서드를 CMFCPropertyGridProperty::EnableSpinControl 호출하여 편집 가능한 스핀 단추 컨트롤을 속성의 오른쪽 가장자리에 표시합니다.

CMFCPropertyGridProperty::Enable

속성을 사용하거나 사용하지 않도록 설정합니다.

void Enable(BOOL bEnable=TRUE);

매개 변수

bEnable
[in] TRUE 속성을 사용하도록 설정하려면 다음을 실행합니다. FALSE 속성을 사용하지 않도록 설정합니다. 비활성화된 속성은 마우스 또는 키보드 입력에 응답하지 않습니다. 기본값은 TRUE입니다.

CMFCPropertyGridProperty::EnableSpinControl

속성 값을 수정하는 데 사용되는 스핀 단추 컨트롤을 사용하거나 사용하지 않도록 설정합니다.

void EnableSpinControl(
    BOOL bEnable=TRUE,
    int nMin=0,
    int nMax=0);

매개 변수

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

nMin
[in] 스핀 단추 컨트롤의 최소값입니다. 기본값은 0입니다.

nMax
[in] 스핀 단추 컨트롤의 최대값입니다. 기본값은 0입니다.

설명

속성을 편집하려고 할 때 프레임워크는 스핀 단추 컨트롤을 자동으로 만듭니다.

생성자의 매개 변수 CMFCPropertyGridProperty::CMFCPropertyGridPropertyvarValue 지정된 속성 형식은 지원되는 변형 형식이어야 합니다. 그렇지 않으면 이 메서드는 디버그 모드에서 어설션됩니다. 지원되는 형식에는 VT_INT, VT_UINT, VT_I2VT_I4, VT_UI2VT_UI4.

CMFCPropertyGridProperty::Expand

하위 속성이 포함된 속성을 확장하거나 축소합니다.

void Expand(BOOL bExpand=TRUE);

매개 변수

bExpand
[in] TRUE 속성을 확장하려면 다음을 실행합니다. FALSE 속성을 축소합니다. 기본값은 TRUE입니다.

CMFCPropertyGridProperty::FormatProperty

속성 값의 텍스트 표현에 서식을 지정합니다.

virtual CString FormatProperty();

Return Value

속성 값의 텍스트 표현입니다.

설명

속성 값이 표시되기 전에 프레임워크에서 이 메서드를 호출합니다.

CMFCPropertyGridProperty::GetData

속성과 DWORD 연결된 값을 검색합니다.

DWORD_PTR GetData() const;

Return Value

DWORD 값입니다.

설명

반환되는 데이터는 숫자 또는 다른 데이터에 대한 포인터와 같은 애플리케이션별 값입니다. 속성을 생성하거나 메서드를 호출할 때 데이터 값을 지정합니다 CMFCPropertyGridProperty::SetData .

CMFCPropertyGridProperty::GetDescription

속성 설명을 검색합니다.

const CString& GetDescription() const;

Return Value

속성 설명을 포함하는 텍스트 문자열입니다.

설명

또한 속성 목록 컨트롤은 이 메서드를 사용하여 속성에 대한 설명을 표시합니다.

CMFCPropertyGridProperty::GetExpandedSubItems

확장된 하위 항목의 수를 검색합니다.

int GetExpandedSubItems(BOOL bIncludeHidden=TRUE) const;

매개 변수

bIncludeHidden
[in] TRUE 개수에 숨겨진 하위 항목 포함 그렇지 않으면 . FALSE 기본값은 TRUE입니다.

Return Value

확장된 하위 항목의 수입니다.

CMFCPropertyGridProperty::GetHierarchyLevel

속성 계층 수준의 인덱스(0부터 시작하는 인덱스)를 검색합니다.

int GetHierarchyLevel() const;

Return Value

속성의 계층 수준입니다.

CMFCPropertyGridProperty::GetName

속성의 이름을 검색합니다.

LPCTSTR GetName() const;

Return Value

속성의 이름을 포함하는 문자열에 대한 포인터입니다.

CMFCPropertyGridProperty::GetNameTooltip

도구 설명에 속성의 이름을 표시하기 위해 프레임워크에서 호출됩니다.

virtual CString GetNameTooltip();

Return Value

속성 이름을 포함하는 문자열입니다. 기본적으로 반환 값은 빈 문자열입니다.

CMFCPropertyGridProperty::GetOption

인덱스로 지정된 옵션의 텍스트를 검색합니다.

LPCTSTR GetOption(int nIndex) const;

매개 변수

nIndex
검색할 속성 목록 항목(옵션)의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

옵션 텍스트가 포함된 문자열에 대한 포인터입니다.

CMFCPropertyGridProperty::GetOptionCount

속성에 속하는 옵션 수를 검색합니다.

int GetOptionCount() const;

Return Value

속성 컨트롤에 포함된 속성 목록 항목(옵션)의 수입니다.

설명

메서드를 CMFCPropertyGridProperty::AddOption 호출하여 속성 목록에 항목을 추가합니다. 메서드를 CMFCPropertyGridProperty::RemoveAllOptions 호출하여 모든 항목을 제거합니다.

CMFCPropertyGridProperty::GetOriginalValue

현재 속성의 초기 값을 검색합니다.

const COleVariant& GetOriginalValue() const;

Return Value

현재 속성의 원래 값입니다.

설명

이 메서드를 사용 하 여 현재 속성의 값을 변경 하는 편집 작업의 효과 실행 취소 합니다.

현재 속성의 원래 값은 생성자에 의해 CMFCPropertyGridProperty::CMFCPropertyGridProperty 설정되고, 메서드에 CMFCPropertyGridProperty::SetOriginalValue 의해 수정되고, 메서드에 의해 다시 설정됩니다 CMFCPropertyGridProperty::ResetOriginalValue .

CMFCPropertyGridProperty::GetParent

부모 속성에 대한 포인터를 검색합니다.

CMFCPropertyGridProperty* GetParent() const;

Return Value

부모 속성 개체 또는 NULL 최상위 속성에 대한 포인터입니다.

CMFCPropertyGridProperty::GetRect

속성의 경계 사각형을 검색합니다.

CRect GetRect() const;

Return Value

CRect 경계 사각형을 설명하는 개체입니다.

CMFCPropertyGridProperty::GetSubItem

0부터 시작하는 인덱스로 식별되는 하위 프로퍼티를 검색합니다.

CMFCPropertyGridProperty* GetSubItem(int nIndex) const;

매개 변수

nIndex
[in] 검색할 속성의 인덱스(0부터 시작하는 인덱스)입니다. 이 매개 변수는 0보다 작거나 하위 속성 수보다 크거나 같은 경우 유효하지 않습니다.

Return Value

이 속성의 자식 항목인 속성 개체에 대한 포인터입니다.

또는

정품 모드에서 NULL 매개 변수가 nIndex 잘못된 경우 디버그 모드에서 이 메서드는 어설션합니다.

CMFCPropertyGridProperty::GetSubItemsCount

하위 항목 수를 검색합니다.

int GetSubItemsCount() const;

Return Value

자식 항목의 수입니다.

CMFCPropertyGridProperty::GetValue

속성 값을 검색합니다.

virtual const _variant_t& GetValue() const;

Return Value

속성 값을 포함하는 변형입니다.

CMFCPropertyGridProperty::GetValueTooltip

프레임워크에서 호출하여 도구 설명에 표시되는 속성 값의 텍스트 표현을 검색합니다.

virtual CString GetValueTooltip();

Return Value

CString 속성 값의 텍스트 표현을 포함하는 개체입니다. 기본적으로 이 값은 빈 문자열입니다.

CMFCPropertyGridProperty::HasButton

속성에 단추가 포함되어 있는지 여부를 나타냅니다.

virtual BOOL HasButton() const;

Return Value

TRUE속성에 단추(또는 속성 목록)가 포함되어 있으면 입니다. 그렇지 않으면 . FALSE

CMFCPropertyGridProperty::HitTest

지점에 해당하는 속성 목록 항목에 해당하는 속성 개체를 가리킵니다.

CMFCPropertyGridProperty* HitTest(
    CPoint point,
    CMFCPropertyGridProperty::ClickArea* pnArea=NULL);

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

매개 변수

point
[in] 클라이언트 좌표에서 테스트할 지점입니다. 이 매개 변수는 일반적으로 현재 마우스 포인터 위치입니다.

pt
[in] 클라이언트 좌표에서 테스트할 지점입니다.

pnArea
[out] 이 메서드가 반환될 때 지정된 점을 포함하는 영역을 나타냅니다. 자세한 내용은 설명 부분을 참조하세요. 기본값은 NULL입니다.

bPropsOnly
[in] TRUE 속성 컨트롤의 모든 영역을 테스트하려면 다음을 실행합니다. FALSE 설명 영역만 테스트합니다. 기본값은 FALSE입니다.

Return Value

속성 개체 또는 NULL.에 대한 포인터입니다.

설명

기본적으로 이 메서드는 속성 항목 내에서 지정된 지점을 찾을 수 없는 경우 속성 하위 항목을 테스트합니다.

다음 표에서는 매개 변수에 반환할 수 있는 값을 나열합니다 pnArea .

영역 설명
ClickArea::ClickExpandBox 더하기 기호(+)로 지정된 확장 상자 컨트롤입니다.
ClickArea::ClickName 속성 이름입니다.
ClickArea::ClickValue 속성 값입니다.

CMFCPropertyGridProperty::Init

속성 개체를 초기화하기 위해 프레임워크에서 호출됩니다.

void Init();

CMFCPropertyGridProperty::IsAllowEdit

속성을 편집할 수 있는지 여부를 나타냅니다.

BOOL IsAllowEdit() const;

Return Value

TRUE 속성을 편집할 수 있는 경우 그렇지 않으면 FALSE.

CMFCPropertyGridProperty::IsEnabled

속성을 사용할지 여부를 나타냅니다.

BOOL IsEnabled() const;

Return Value

TRUE 속성을 사용하도록 설정하면 FALSE 속성을 사용할 수 없으면 입니다.

설명

속성을 사용할 수 있는지 여부를 지정합니다.

CMFCPropertyGridProperty::IsExpanded

속성이 확장 또는 축소되는지 여부를 나타냅니다.

BOOL IsExpanded() const;

Return Value

TRUE 속성이 확장되면 FALSE 속성이 축소되면

CMFCPropertyGridProperty::IsGroup

현재 속성이 그룹을 나타내는지 여부를 나타냅니다.

BOOL IsGroup() const;

Return Value

TRUE 현재 속성 개체가 그룹을 나타내는 경우 FALSE 속성이 값을 나타내는 경우

설명

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

CMFCPropertyGridProperty::IsInPlaceEditing

현재 속성을 편집할 수 있는지 여부를 나타냅니다.

BOOL IsInPlaceEditing() const;

Return Value

TRUE현재 속성을 편집할 수 있는 경우 그렇지 않으면 . FALSE

CMFCPropertyGridProperty::IsModified

현재 속성이 수정되었는지 여부를 나타냅니다.

BOOL IsModified() const;

Return Value

TRUE속성이 수정되면 다음을 실행합니다. 그렇지 않으면 . FALSE

CMFCPropertyGridProperty::IsParentExpanded

현재 속성의 부모가 확장되는지 여부를 나타냅니다.

BOOL IsParentExpanded() const;

Return Value

TRUE 현재 속성의 모든 부모가 확장되면 FALSE 부모 속성이 축소된 경우

CMFCPropertyGridProperty::IsSelected

현재 속성이 선택되어 있는지 여부를 나타냅니다.

virtual BOOL IsSelected() const;

Return Value

TRUE현재 속성이 선택되어 있으면 FALSE

CMFCPropertyGridProperty::IsSubItem

지정된 속성이 현재 속성의 하위 항목인지 여부를 나타냅니다.

BOOL IsSubItem(CMFCPropertyGridProperty* pProp) const;

매개 변수

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

Return Value

TRUE지정된 속성이 현재 속성의 하위 항목이면 FALSE

CMFCPropertyGridProperty::IsValueChanged

현재 속성의 값이 변경되었는지 여부를 나타냅니다.

virtual BOOL IsValueChanged() const;

Return Value

TRUE현재 속성의 값이 변경된 경우 그렇지 않으면 . FALSE

CMFCPropertyGridProperty::IsVisible

현재 속성이 표시되는지 여부를 나타냅니다.

BOOL IsVisible() const;

Return Value

TRUE 현재 속성이 표시되면 FALSE. .

CMFCPropertyGridProperty::m_strFormatDouble

double 형식의 값에 대한 형식 문자열을 보유합니다.

static CString m_strFormatDouble;

CMFCPropertyGridProperty::m_strFormatFloat

float 형식의 값에 대한 형식 문자열을 보유합니다.

static CString m_strFormatFloat;

CMFCPropertyGridProperty::m_strFormatLong

long 형식의 값에 대한 형식 문자열을 보유합니다.

static CString m_strFormatLong;

CMFCPropertyGridProperty::m_strFormatShort

짧은 형식의 값에 대한 형식 문자열을 보유합니다.

static CString m_strFormatShort;

CMFCPropertyGridProperty::OnClickButton

사용자가 속성에 포함된 단추를 선택할 때 프레임워크에서 호출됩니다.

virtual void OnClickButton(CPoint point);

매개 변수

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

설명

기본적으로 이 메서드는 아무것도 수행하지 않습니다.

CMFCPropertyGridProperty::OnClickName

사용자가 속성의 이름 필드를 선택할 때 부모 속성 목록 컨트롤에서 호출됩니다.

virtual void OnClickName(CPoint C);

매개 변수

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

설명

기본적으로 이 메서드는 아무것도 수행하지 않습니다.

CMFCPropertyGridProperty::OnClickValue

사용자가 속성의 값 필드를 선택할 때 부모 속성 목록 컨트롤에서 호출됩니다.

virtual BOOL OnClickValue(
    UINT uiMsg,
    CPoint point);

매개 변수

uiMsg
[in] 마우스 메시지입니다.

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

Return Value

TRUE지정한 마우스 메시지가 이 메서드에서 처리되면 이고, 그렇지 않으면 . FALSE

설명

기본적으로 이 메서드는 현재 속성을 편집할 수 없는 경우 반환 FALSE 합니다. 그렇지 않으면 이 속성과 연결된 편집 또는 스핀 컨트롤이 지정된 마우스 메시지를 처리한 다음 이 메서드가 반환됩니다 TRUE.

CMFCPropertyGridProperty::OnCloseCombo

속성에 포함된 콤보 상자를 닫을 때 프레임워크에서 호출됩니다.

virtual void OnCloseCombo();

CMFCPropertyGridProperty::OnCtlColor

속성의 배경색을 채우기 위해 브러시를 검색해야 하는 경우 프레임워크에서 호출됩니다.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

매개 변수

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

nCtlColor
[in] (이 매개 변수는 사용되지 않습니다.)

Return Value

이 메서드가 성공하면 브러시에 대한 핸들입니다. 그렇지 않으면 . NULL

CMFCPropertyGridProperty::OnDblClk

사용자가 속성을 두 번 클릭할 때 프레임워크에서 호출됩니다.

virtual BOOL OnDblClk(CPoint point);

매개 변수

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

Return Value

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

설명

기본적으로 이 메서드는 속성 목록 컨트롤에서 다음 속성 항목을 선택합니다.

CMFCPropertyGridProperty::OnDestroyWindow

속성이 제거되거나 편집이 완료되면 프레임워크에서 호출됩니다.

virtual void OnDestroyWindow();

CMFCPropertyGridProperty::OnDrawButton

속성에 포함된 단추를 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDrawButton(
    CDC* pDC,
    CRect rectButton);

매개 변수

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

rectButton
[in] 단추를 그릴 위치를 지정하는 경계 사각형입니다.

CMFCPropertyGridProperty::OnDrawDescription

속성 설명을 그리기 위해 프레임워크에서 호출됩니다.

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

매개 변수

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

rect
[in] 속성 설명을 그릴 위치를 지정하는 경계 사각형입니다.

설명

기본적으로 이 메서드는 부모 속성 목록 컨트롤에서 사용하는 글꼴에 속성 이름 및 설명을 그립니다. 속성 설명은 일반 스타일로 그려지고 속성 이름은 굵은 스타일로 그려집니다.

CMFCPropertyGridProperty::OnDrawExpandBox

하위 속성이 포함된 속성 근처에 확장 상자 컨트롤을 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDrawExpandBox(
    CDC* pDC,
    CRect rectExpand);

매개 변수

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

rectExpand
[in] 확장 상자 컨트롤을 그릴 위치를 지정하는 경계 사각형입니다.

설명

확장 상자 컨트롤을 선택하여 하위 속성 목록을 확장하거나 축소합니다. 확장 상자 컨트롤은 더하기() 또는 빼기(+-) 기호가 포함된 사각형으로 지정됩니다. 더하기 기호는 하위 속성 목록을 표시하도록 속성을 확장할 수 있음을 나타냅니다. 빼기 기호는 속성만 표시하도록 목록을 축소할 수 있음을 나타냅니다.

CMFCPropertyGridProperty::OnDrawName

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

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

매개 변수

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

rect
[in] 속성 이름을 그릴 위치를 지정하는 경계 사각형입니다.

CMFCPropertyGridProperty::OnDrawValue

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

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

매개 변수

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

rect
[in] 속성 값을 그릴 위치를 지정하는 경계 사각형입니다.

CMFCPropertyGridProperty::OnEdit

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

virtual BOOL OnEdit(LPPOINT lptClick);

매개 변수

lptClick
[in] (이 매개 변수는 사용되지 않습니다.) 클라이언트 좌표의 지점에 대한 포인터입니다.

Return Value

TRUE편집 작업이 성공적으로 시작되면 이고, 그렇지 않으면 . FALSE

설명

이 함수는 사용자가 속성 값을 수정하려고 할 때 프레임워크에서 호출됩니다. 기본적으로 이 메서드는 콤보 상자 컨트롤 또는 스핀 컨트롤에 적합한 편집기를 시작합니다.

CMFCPropertyGridProperty::OnEndEdit

사용자가 속성 값 수정을 마쳤을 때 프레임워크에서 호출됩니다.

virtual BOOL OnEndEdit();

Return Value

이 메서드는 항상 TRUE을 반환합니다.

설명

기본적으로 이 메서드는 현재 편집 컨트롤을 삭제한 다음 반환합니다 TRUE.

CMFCPropertyGridProperty::OnKillFocus

속성이 입력 포커스를 잃을 때 프레임워크에서 호출됩니다.

virtual BOOL OnKillFocus(CWnd*);

매개 변수

CWnd
[in] (사용되지 않음) 창에 대한 포인터입니다.

Return Value

이 메서드는 항상 TRUE을 반환합니다.

설명

기본적으로 이 메서드는 아무 작업도 수행하지 않으며 .TRUE 이 메서드를 재정의하는 경우 속성이 입력 포커스를 잃을 때 프레임워크가 편집 작업을 종료할 수 있는지 반환 TRUE 합니다.

CMFCPropertyGridProperty::OnKillSelection

virtual void OnKillSelection(CMFCPropertyGridProperty*);

매개 변수

[in] CMFCPropertyGridProperty*\

설명

기본적으로 이 메서드는 아무것도 수행하지 않습니다.

CMFCPropertyGridProperty::OnPosSizeChanged

virtual void OnPosSizeChanged(CRect);

매개 변수

[in] CRect\

설명

기본적으로 이 메서드는 아무것도 수행하지 않습니다.

CMFCPropertyGridProperty::OnRClickName

사용자가 속성 이름 영역에서 마우스 오른쪽 단추를 선택할 때 프레임워크에서 호출됩니다.

virtual void OnRClickName(CPoint C);

매개 변수

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

설명

기본적으로 이 메서드는 아무것도 수행하지 않습니다.

CMFCPropertyGridProperty::OnRClickValue

사용자가 속성 값 영역에서 마우스 오른쪽 단추를 선택할 때 프레임워크에서 호출됩니다.

virtual void OnRClickValue(
    CPoint C,
    BOOL B);

매개 변수

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

B
[in] 부울.

설명

기본적으로 이 메서드는 아무 작업도 수행하지 않으며 B 매개 변수에는 미리 정의된 용도가 없습니다.

CMFCPropertyGridProperty::OnSelectCombo

사용자가 편집 가능한 콤보 상자에서 항목을 선택할 때 프레임워크에서 호출됩니다.

virtual void OnSelectCombo();

설명

기본적으로 이 메서드는 선택한 항목의 텍스트를 사용하여 속성 값을 업데이트합니다.

CMFCPropertyGridProperty::OnSetCursor

마우스 포인터가 속성 항목으로 이동할 때 프레임워크에서 호출됩니다.

virtual BOOL OnSetCursor() const;

Return Value

TRUE현재 속성이 변형 형식 또는 값 목록인 경우 이 메서드는 삽입 지점(I-beam) 마우스 커서를 성공적으로 로드합니다. 그렇지 않으면 . FALSE

설명

이 메서드는 다음과 같은 변형 형식VT_INTVT_UINTVT_R8VT_I2VT_UI1VT_BSTRVT_I4VT_UI2VT_UI4VT_R4지원합니다.

CMFCPropertyGridProperty::OnSetSelection

virtual void OnSetSelection CMFCPropertyGridProperty*);

매개 변수

[in] CMFCPropertyGridProperty*\

설명

기본적으로 이 메서드는 아무것도 수행하지 않습니다.

CMFCPropertyGridProperty::OnUpdateValue

편집 가능한 속성 값이 변경되었을 때 프레임워크에서 호출됩니다.

virtual BOOL OnUpdateValue();

Return Value

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

CMFCPropertyGridProperty::PushChar

속성이 선택되고 사용자가 새 문자를 입력할 때 속성 목록 컨트롤에서 호출됩니다.

virtual BOOL PushChar(UINT nChar);

매개 변수

nChar
[in] 문자입니다.

Return Value

TRUE편집 작업이 계속되면 이고, 그렇지 않으면 . FALSE

설명

이 메서드는 값 목록 또는 다음 변형 형식 VT_INTVT_I4VT_R8VT_I2VT_UI1VT_BSTRVT_UINTVT_UI2VT_UI4VT_R4중 하나인 속성을 지원합니다.

CMFCPropertyGridProperty::Redraw

속성을 다시 그어 줍니다.

void Redraw();

CMFCPropertyGridProperty::RemoveAllOptions

속성에서 모든 옵션(항목)을 제거합니다.

void RemoveAllOptions();

설명

옵션은 속성 목록 컨트롤의 목록 항목이라고도합니다.

CMFCPropertyGridProperty::RemoveSubItem

지정된 하위 사이트를 제거합니다.

BOOL RemoveSubItem(
    CMFCPropertyGridProperty*& pProp,
    BOOL bDelete=TRUE);

매개 변수

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

bDelete
[in] TRUE 매개 변수에 의해 지정된 속성 개체를 삭제하려면 pProp , FALSE그렇지 않으면 .입니다. 기본값은 TRUE입니다.

Return Value

설명

bDelete 지정된 하위 항목을 이동하려는 경우 매개 변수를 지정 FALSE 합니다. 즉, 하위 항목을 제거한 다음 다른 곳에 추가합니다.

CMFCPropertyGridProperty::ResetOriginalValue

편집된 속성의 원래 값을 복원합니다.

virtual void ResetOriginalValue();

CMFCPropertyGridProperty::SetData

DWORD 값을 속성과 연결합니다.

void SetData(DWORD_PTR dwData);

매개 변수

dwData
[in] 정수 또는 다른 데이터에 대한 포인터와 같은 애플리케이션별 32비트 값입니다.

설명

메서드를 CMFCPropertyGridProperty::GetData 사용하여 값을 검색합니다 DWORD . 메서드를 CMFCPropertyGridCtrl::FindItemByData 사용하여 지정된 DWORD 값과 연결된 속성 목록 항목을 찾습니다.

CMFCPropertyGridProperty::SetDescription

현재 속성을 설명하는 텍스트를 지정합니다.

void SetDescription(const CString& strDescr);

매개 변수

strDescr
[in] 현재 속성을 설명하는 텍스트입니다.

CMFCPropertyGridProperty::SetName

속성의 이름을 설정합니다.

void SetName(
    LPCTSTR lpszName,
    BOOL bRedraw=TRUE);

매개 변수

lpszName
[in] 속성 이름입니다.

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

CMFCPropertyGridProperty::SetOriginalValue

편집 가능한 속성의 원래 값을 설정합니다.

virtual void SetOriginalValue(const COleVariant& varValue);

매개 변수

varValue
[in] 값입니다.

설명

메서드를 CMFCPropertyGridProperty::ResetOriginalValue 사용하여 편집된 속성의 원래 값을 다시 설정합니다.

CMFCPropertyGridProperty::SetValue

속성 표 속성의 값을 설정합니다.

virtual void SetValue(const _variant_t& varValue);

매개 변수

varValue
[in] 속성을 설정할 값에 대한 참조입니다.

예: SetValue

void SetPropBarValue(UINT propId, const DWORD& barPropDwordValue)
{
  auto property = propertiesGridCtrlList.FindItemByData(propId);
  if (property != nullptr)
  {
    property->SetValue(static_cast<_variant_t >(barPropDwordValue == 1)); // set value to true or false depending on dword value
  }
}

CMFCPropertyGridProperty::Show

속성을 표시하거나 숨깁니다.

void Show(
    BOOL bShow=TRUE,
    BOOL bAdjustLayout=TRUE);

매개 변수

bShow
[in] TRUE 현재 속성 및 하위 항목 표시 FALSE 현재 속성 및 하위 항목 숨기기 기본값은 TRUE입니다.

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

참고 항목

계층 구조 차트
클래스
CMFCPropertyGridCtrl 클래스