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::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();
상속 계층 구조
요구 사항
헤더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
설명
이 메서드는 클래스 생성자에 지정된 , lpszEditMask및 lpszEditTemplatelpszValidChars 매개 변수의 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::CMFCPropertyGridProperty 로 varValue 지정된 속성 형식은 지원되는 변형 형식이어야 합니다. 그렇지 않으면 이 메서드는 디버그 모드에서 어설션됩니다. 지원되는 형식에는 VT_INT, VT_UINT, VT_I2VT_I4, VT_UI2및 VT_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_INT을 VT_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입니다.
참고 항목
피드백
출시 예정: 2024년 내내 콘텐츠 피드백 메커니즘인 GitHub 문제를 단계적으로 폐지하고 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 https://aka.ms/ContentUserFeedback을 참조하세요.
다음에 대한 사용자 의견 제출 및 보기