CMFCPropertyGridCtrl 클래스

아티클
04/10/2013

이 항목은 완전성을 위해서 포함되었습니다. 더 자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하십시오.

속성 사전순 또는 계층적 순서로 표시할 수 있는 편집 가능한 속성 표 컨트롤을 지원 합니다.

class CMFCPropertyGridCtrl : public CWnd

Members

Public 생성자

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

Public 메서드

Name	설명
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	지정한 개체의 현재 상태를 검색 하는 프레임 워크에서 호출 됩니다.(재정의 서비스.)
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	속성 표 컨트롤 항목의 지정 된 인덱스에 해당 하는 property 개체에 대 한 포인터를 검색 합니다.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	속성 값이 포함 된 열의 현재 너비를 검색 합니다.
CMFCPropertyGridCtrl::GetPropertyCount	속성 표 컨트롤에서 속성을 검색합니다.
CMFCPropertyGridCtrl::GetRowHeight	속성 표 컨트롤에 있는 행의 높이 검색합니다.
CMFCPropertyGridCtrl::GetScrollBarCtrl	속성 표 컨트롤에서 스크롤 막대 컨트롤에 대 한 포인터를 검색합니다.(재정의 CWnd::GetScrollBarCtrl.)
CMFCPropertyGridCtrl::GetTextColor	현재 속성 표 컨트롤에서 속성 항목의 텍스트 색을 검색합니다.
CMFCPropertyGridCtrl::GetThisClass	프레임 워크에서 사용 되는 포인터를 얻을 수 있는 CRuntimeClass 이 클래스 형식에 연결 된 개체입니다.
CMFCPropertyGridCtrl::HitTest	지정 된 항목의 경우 속성 표 컨트롤 항목에 해당 하는 속성 개체에 대 한 포인터를 검색 합니다.이 메서드 또한 지점을 포함 하는 속성 표 컨트롤에서 영역을 나타냅니다.
CMFCPropertyGridCtrl::InitHeader	내부 초기화 CMFCHeaderCtrl 개체 프레임 워크 사용 현재 속성 표 컨트롤을 표시 합니다.
CMFCPropertyGridCtrl::IsAlphabeticMode	속성 표 컨트롤에서 알파벳 모드 인지 여부를 나타냅니다.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	설명 영역 속성 표 컨트롤의 표시 여부를 나타냅니다.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	현재 속성 표 컨트롤의 너비에 각 속성 그룹 이름 표시 여부를 나타냅니다.
CMFCPropertyGridCtrl::IsHeaderCtrl	헤더 컨트롤을 표시할지 여부를 나타냅니다.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	수정 된 속성 속성 표 컨트롤에 표시 되는 방식을 나타냅니다.
CMFCPropertyGridCtrl::IsShowDragContext	사용자가 열의 크기를 조정할 때 현재 속성 표 컨트롤의 이름 및 값 열 프레임 워크를 다시 그리는지 여부를 나타냅니다.
CMFCPropertyGridCtrl::IsVSDotNetLook	VS.net에서 사용 되는 스타일 속성 표 컨트롤의 모양 인지 여부를 나타냅니다.
CMFCPropertyGridCtrl::MarkModifiedProperties	수정 된 속성을 표시 하는 방법을 지정 합니다.
CMFCPropertyGridCtrl::PreTranslateMessage	클래스에 의해 사용 되는 CWinApp 창 메시지를 디스패치하기 전에 변환 하는 TranslateMessage 및 DispatchMessage Windows 기능.(재정의 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	현재 선택한 색 속성 색 값을 설정합니다.

Protected 메서드

Name	설명
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 클래스	글꼴을 선택 하는 데 사용 되는 속성입니다.

그림

다음 그림에서는 두 가지 방법으로 속성 표시 속성 표 컨트롤을 나타냅니다.첫 그림 등록 정보를 계층 구조적으로 표시 하 고 두 번째 속성을 사전순으로 표시 합니다.

속성 목록 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();