다음을 통해 공유


COlePropertyPage 클래스

대화 상자와 유사한 그래픽 인터페이스의 사용자 지정 컨트롤의 속성을 표시하는 데 사용됩니다.

구문

class AFX_NOVTABLE COlePropertyPage : public CDialog

멤버

공용 생성자

속성 설명
COlePropertyPage::COlePropertyPage COlePropertyPage 개체를 생성합니다.

공용 메서드

이름 설명
COlePropertyPage::GetControlStatus 사용자가 컨트롤의 값을 수정했는지 여부를 나타냅니다.
COlePropertyPage::GetObjectArray 속성 페이지에서 편집 중인 개체의 배열을 반환합니다.
COlePropertyPage::GetPageSite 속성 페이지의 인터페이스에 대한 포인터를 IPropertyPageSite 반환합니다.
COlePropertyPage::IgnoreApply 적용 단추를 사용하도록 설정하지 않는 컨트롤을 결정합니다.
COlePropertyPage::IsModified 사용자가 속성 페이지를 수정했는지 여부를 나타냅니다.
COlePropertyPage::OnEditProperty 사용자가 속성을 편집할 때 프레임워크에서 호출됩니다.
COlePropertyPage::OnHelp 사용자가 도움말을 호출할 때 프레임워크에서 호출됩니다.
COlePropertyPage::OnInitDialog 속성 페이지가 초기화될 때 프레임워크에서 호출됩니다.
COlePropertyPage::OnObjectsChanged 새 속성을 사용하는 다른 OLE 컨트롤이 선택되면 프레임워크에서 호출됩니다.
COlePropertyPage::OnSetPageSite 속성 프레임이 페이지의 사이트를 제공하는 경우 프레임워크에서 호출됩니다.
COlePropertyPage::SetControlStatus 사용자가 컨트롤의 값을 수정했는지 여부를 나타내는 플래그를 설정합니다.
COlePropertyPage::SetDialogResource 속성 페이지의 대화 상자 리소스를 설정합니다.
COlePropertyPage::SetHelpInfo 속성 페이지의 간단한 도움말 텍스트, 도움말 파일의 이름 및 도움말 컨텍스트를 설정합니다.
COlePropertyPage::SetModifiedFlag 사용자가 속성 페이지를 수정했는지 여부를 나타내는 플래그를 설정합니다.
COlePropertyPage::SetPageName 속성 페이지의 이름(캡션)을 설정합니다.

설명

예를 들어 속성 페이지에는 사용자가 컨트롤의 캡션 속성을 보고 수정할 수 있는 편집 컨트롤이 포함될 수 있습니다.

각 사용자 지정 또는 주식 제어 속성에는 컨트롤의 사용자가 현재 속성 값을 보고 필요한 경우 해당 값을 수정할 수 있는 대화 상자 컨트롤이 있을 수 있습니다.

사용에 COlePropertyPage대한 자세한 내용은 ActiveX 컨트롤: 속성 페이지 문서를 참조하세요.

상속 계층 구조

CObject

CCmdTarget

CWnd

Cdialog

COlePropertyPage

요구 사항

헤더: afxctl.h

COlePropertyPage::COlePropertyPage

COlePropertyPage 개체를 생성합니다.

COlePropertyPage(
    UINT idDlg,
    UINT idCaption);

매개 변수

idDlg
대화 상자 템플릿의 리소스 ID입니다.

idCaption
속성 페이지의 캡션 리소스 ID입니다.

설명

서브클래스를 COlePropertyPage구현하는 경우 서브클래스의 생성자는 생성자를 사용하여 COlePropertyPage 속성 페이지의 기반이 되는 대화 상자 템플릿 리소스와 해당 캡션 포함하는 문자열 리소스를 식별해야 합니다.

COlePropertyPage::GetControlStatus

사용자가 지정된 리소스 ID를 사용하여 속성 페이지 컨트롤의 값을 수정했는지 여부를 결정합니다.

BOOL GetControlStatus(UINT nID);

매개 변수

nID
속성 페이지 컨트롤의 리소스 ID입니다.

Return Value

컨트롤 값이 수정된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

COlePropertyPage::GetObjectArray

속성 페이지에서 편집 중인 개체의 배열을 반환합니다.

LPDISPATCH* GetObjectArray(ULONG* pnObjects);

매개 변수

pnObjects
페이지에서 편집할 개체 수를 받을 부호 없는 긴 정수에 대한 포인터입니다.

Return Value

속성 페이지에서 각 컨트롤의 IDispatch 속성에 액세스하는 데 사용되는 포인터 배열에 대한 포인터입니다. 호출자는 이러한 인터페이스 포인터를 해제해서는 안 됩니다.

설명

각 속성 페이지 개체는 기본 페이지에서 편집되는 개체의 인터페이스에 IDispatch 대한 포인터 배열을 지정합니다. 이 함수는 해당 pnObjects 인수를 해당 배열의 요소 수로 설정하고 배열의 첫 번째 요소에 대한 포인터를 반환합니다.

COlePropertyPage::GetPageSite

속성 페이지의 인터페이스에 대한 포인터를 IPropertyPageSite 가져옵니다.

LPPROPERTYPAGESITE GetPageSite();

Return Value

속성 페이지의 인터페이스에 대한 포인터입니다 IPropertyPageSite .

설명

컨트롤과 컨테이너는 사용자가 컨트롤 속성을 찾아보고 편집할 수 있도록 협력합니다. 컨트롤은 속성 페이지를 제공하며, 각각은 사용자가 관련 속성 집합을 편집할 수 있는 OLE 개체입니다. 컨테이너는 속성 페이지를 표시하는 속성 프레임을 제공합니다. 각 페이지에 대해 속성 프레임은 인터페이스를 지원하는 IPropertyPageSite 페이지 사이트를 제공합니다.

COlePropertyPage::IgnoreApply

적용 단추를 사용하도록 설정하지 않는 컨트롤을 결정합니다.

void IgnoreApply(UINT nID);

매개 변수

nID
무시할 컨트롤의 ID입니다.

설명

속성 페이지의 적용 단추는 속성 페이지 컨트롤의 값이 변경된 경우에만 사용하도록 설정됩니다. 이 함수를 사용하여 값이 변경될 때 적용 단추를 사용하도록 설정하지 않는 컨트롤을 지정합니다.

COlePropertyPage::IsModified

사용자가 속성 페이지에서 값을 변경했는지 여부를 결정합니다.

BOOL IsModified();

Return Value

속성 페이지가 수정된 경우 TRUE입니다.

COlePropertyPage::OnEditProperty

프레임워크는 특정 속성을 편집할 때 이 함수를 호출합니다.

virtual BOOL OnEditProperty(DISPID dispid);

매개 변수

dispid
편집 중인 속성의 디스패치 ID입니다.

Return Value

기본 구현은 FALSE를 반환합니다. 이 함수의 재정의는 TRUE를 반환해야 합니다.

설명

페이지의 적절한 컨트롤로 포커스를 설정하도록 재정의할 수 있습니다. 기본 구현은 아무 것도 수행하지 않으며 FALSE를 반환합니다.

COlePropertyPage::OnHelp

프레임워크는 사용자가 온라인 도움말을 요청할 때 이 함수를 호출합니다.

virtual BOOL OnHelp(LPCTSTR lpszHelpDir);

매개 변수

lpszHelpDir
속성 페이지의 도움말 파일이 포함된 디렉터리입니다.

Return Value

기본 구현은 FALSE를 반환합니다.

설명

사용자가 도움말에 액세스할 때 속성 페이지에서 특별한 작업을 수행해야 하는 경우 재정의합니다. 기본 구현은 아무 작업도 수행하지 않으며 프레임워크에 WinHelp를 호출하도록 지시하는 FALSE를 반환합니다.

COlePropertyPage::OnInitDialog

프레임워크는 속성 페이지의 대화 상자가 초기화될 때 이 함수를 호출합니다.

virtual BOOL OnInitDialog();

Return Value

기본 구현은 FALSE를 반환합니다.

설명

대화 상자가 초기화될 때 특별한 작업이 필요한 경우 재정의합니다. 기본 구현은 FALSE를 호출 CDialog::OnInitDialog 하고 반환합니다.

COlePropertyPage::OnObjectsChanged

새 속성을 사용하는 다른 OLE 컨트롤이 선택되면 프레임워크에서 호출됩니다.

virtual void OnObjectsChanged();

설명

개발자 환경에서 OLE 컨트롤의 속성을 볼 때 모덜리스 대화 상자를 사용하여 해당 속성 페이지를 표시합니다. 다른 컨트롤을 선택한 경우 새 속성 집합에 대해 다른 속성 페이지 집합을 표시해야 합니다. 프레임워크는 이 함수를 호출하여 속성 페이지에 변경 사항을 알립니다.

이 작업에 대한 알림을 받고 특수 작업을 수행하도록 이 함수를 재정의합니다.

COlePropertyPage::OnSetPageSite

속성 프레임이 속성 페이지의 페이지 사이트를 제공하는 경우 프레임워크는 이 함수를 호출합니다.

virtual void OnSetPageSite();

설명

기본 구현은 페이지의 캡션 로드하고 대화 상자 리소스에서 페이지의 크기를 확인하려고 시도합니다. 속성 페이지에 추가 작업이 필요한 경우 이 함수를 재정의합니다. 재정의는 기본 클래스 구현을 호출해야 합니다.

COlePropertyPage::SetControlStatus

속성 페이지 컨트롤의 상태 변경합니다.

BOOL SetControlStatus(
    UINT nID,
    BOOL bDirty);

매개 변수

nID
속성 페이지 컨트롤의 ID를 포함합니다.

bDirty
속성 페이지의 필드가 수정되었는지를 지정합니다. 필드가 수정된 경우 TRUE로, 수정되지 않은 경우 FALSE로 설정합니다.

Return Value

지정된 컨트롤이 설정된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

속성 페이지를 닫거나 적용 단추를 선택할 때 속성 페이지 컨트롤의 상태 더티 경우 컨트롤의 속성이 적절한 값으로 업데이트됩니다.

COlePropertyPage::SetDialogResource

속성 페이지의 대화 상자 리소스를 설정합니다.

void SetDialogResource(HGLOBAL hDialog);

매개 변수

hDialog
속성 페이지의 대화 상자 리소스에 대한 핸들입니다.

COlePropertyPage::SetHelpInfo

도구 설명 정보, 도움말 파일 이름 및 속성 페이지의 도움말 컨텍스트를 지정합니다.

void SetHelpInfo(
    LPCTSTR lpszDocString,
    LPCTSTR lpszHelpFile = NULL,
    DWORD dwHelpContext = 0);

매개 변수

lpszDocString
상태 표시줄 또는 기타 위치에 표시할 간단한 도움말 정보가 들어 있는 문자열입니다.

lpszHelpFile
속성 페이지의 도움말 파일 이름입니다.

dwHelpContext
속성 페이지의 도움말 컨텍스트입니다.

COlePropertyPage::SetModifiedFlag

사용자가 속성 페이지를 수정했는지 여부를 나타냅니다.

void SetModifiedFlag(BOOL bModified = TRUE);

매개 변수

bModified
속성 페이지의 수정된 플래그에 대한 새 값을 지정합니다.

COlePropertyPage::SetPageName

속성 프레임이 일반적으로 페이지 탭에 표시되는 속성 페이지의 이름을 설정합니다.

void SetPageName(LPCTSTR lpszPageName);

매개 변수

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

참고 항목

MFC 샘플 CIRC3
MFC 샘플 TESTHELP
CDialog 클래스
계층 구조 차트
CDialog 클래스