COlePropertiesDialog 클래스

Windows 공용 OLE 개체 속성 대화 상자를 캡슐화합니다.

구문

class COlePropertiesDialog : public COleDialog

멤버

공용 생성자

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

공용 메서드

이름	설명
COlePropertiesDialog::D oModal	대화 상자를 표시하고 사용자가 선택할 수 있도록 합니다.
COlePropertiesDialog::OnApplyScale	문서 항목의 크기 조정이 변경될 때 프레임워크에서 호출됩니다.

공용 데이터 멤버

속성	설명
COlePropertiesDialog::m_gp	개체의 "일반" 페이지를 초기화하는 데 사용되는 구조체입니다 COlePropertiesDialog .
COlePropertiesDialog::m_lp	개체의 "링크" 페이지를 초기화하는 데 사용되는 구조체입니다 COlePropertiesDialog .
COlePropertiesDialog::m_op	개체를 초기화하는 데 사용되는 구조체입니다 COlePropertiesDialog .
COlePropertiesDialog::m_psh	사용자 지정 속성 페이지를 추가하는 데 사용되는 구조체입니다.
COlePropertiesDialog::m_vp	개체의 "보기" 페이지를 사용자 지정하는 데 사용되는 구조체입니다 COlePropertiesDialog .

설명

일반적인 OLE 개체 속성 대화 상자는 Windows 표준과 일치하는 방식으로 OLE 문서 항목의 속성을 쉽게 표시하고 수정할 수 있는 방법을 제공합니다. 이러한 속성에는 문서 항목이 나타내는 파일에 대한 정보, 아이콘 및 이미지 크기 조정을 표시하는 옵션, 항목 링크에 대한 정보(항목이 연결된 경우)가 포함됩니다.

개체를 COlePropertiesDialog 사용하려면 먼저 생성자를 사용하여 개체를 COlePropertiesDialog 만듭니다. 대화 상자가 생성된 후 멤버 함수를 DoModal 호출하여 대화 상자를 표시하고 사용자가 항목의 속성을 수정할 수 있도록 합니다. DoModal 는 사용자가 확인(IDOK) 또는 취소(IDCANCEL) 단추를 선택했는지 여부를 반환합니다. 확인 및 취소 단추 외에도 적용 단추가 있습니다. 사용자가 적용을 선택하면 문서 항목의 속성에 대한 변경 내용이 항목에 적용되고 해당 이미지가 자동으로 업데이트되지만 활성 상태로 유지됩니다.

m_psh 데이터 멤버는 구조체에 PROPSHEETHEADER 대한 포인터이며 대부분의 경우 명시적으로 액세스할 필요가 없습니다. 한 가지 예외는 기본 일반, 보기 및 링크 페이지 이외의 추가 속성 페이지가 필요한 경우입니다. 이 경우 멤버 함수를 m_psh 호출하기 전에 사용자 지정 페이지를 포함하도록 데이터 멤버를 수정할 DoModal 수 있습니다.

OLE 대화 상자에 대한 자세한 내용은 OLE의 문서 대화 상자를 참조하세요.

상속 계층 구조

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COlePropertiesDialog

요구 사항

헤더: afxodlgs.h

COlePropertiesDialog::COlePropertiesDialog

COlePropertiesDialog 개체를 만듭니다.

COlePropertiesDialog(
    COleClientItem* pItem,
    UINT nScaleMin = 10,
    UINT nScaleMax = 500,
    CWnd* pParentWnd = NULL);

매개 변수

pItem
속성에 액세스하는 문서 항목에 대한 포인터입니다.

nScaleMin
문서 항목 이미지의 최소 크기 조정 백분율입니다.

nScaleMax
문서 항목 이미지의 최대 크기 조정 백분율입니다.

pParentWnd
대화 상자의 부모 또는 소유자에 대한 포인터입니다.

설명

문서 항목에 대한 크기 조정을 구현하기 위해 일반적인 OLE 개체 속성 대화 상자 클래스 COlePropertiesDialog 를 파생합니다. 이 클래스의 인스턴스에서 구현하는 대화 상자는 문서 항목의 크기 조정을 지원하지 않습니다.

기본적으로 일반적인 OLE 개체 속성 대화 상자에는 세 개의 기본 페이지가 있습니다.

• 일반

  이 페이지에는 선택한 문서 항목이 나타내는 파일에 대한 시스템 정보가 포함되어 있습니다. 이 페이지에서 사용자는 선택한 항목을 다른 형식으로 변환할 수 있습니다.

• 보기

  이 페이지에는 항목을 표시하고, 아이콘을 변경하고, 이미지의 크기 조정을 변경하는 옵션이 포함되어 있습니다.

• 링크

  이 페이지에는 연결된 항목의 위치를 변경하고 연결된 항목을 업데이트하는 옵션이 포함되어 있습니다. 이 페이지에서 사용자는 선택한 항목의 링크를 끊을 수 있습니다.

기본적으로 제공된 페이지 이외의 페이지를 추가하려면 파생 클래스의 생성자를 종료하기 전에 m_psh 멤버 변수를 수정합니다COlePropertiesDialog. 이는 생성자의 고급 구현 COlePropertiesDialog 입니다.

COlePropertiesDialog::D oModal

이 멤버 함수를 호출하여 Windows 공통 OLE 개체 속성 대화 상자를 표시하고 사용자가 문서 항목의 다양한 속성을 보거나 변경할 수 있도록 합니다.

virtual INT_PTR DoModal();

Return Value

IDOK 또는 IDCANCEL이 성공하면 입니다. 그렇지 않으면 0입니다. IDOK 및 IDCANCEL은 사용자가 확인 또는 취소 단추를 선택했는지 여부를 나타내는 상수입니다.

IDCANCEL이 반환되면 Windows CommDlgExtendedError 함수를 호출하여 오류가 발생했는지 여부를 확인할 수 있습니다.

COlePropertiesDialog::m_gp

OLE 개체 속성 대화 상자의 일반 페이지를 초기화하는 데 사용되는 OLEUIGNRLPROPS 형식의 구조체입니다.

OLEUIGNRLPROPS m_gp;

설명

이 페이지에는 포함의 유형과 크기가 표시되며 사용자가 변환 대화 상자에 액세스할 수 있습니다. 개체가 링크인 경우 이 페이지에는 링크 대상도 표시됩니다.

구조에 OLEUIGNRLPROPS 대한 자세한 내용은 Windows SDK를 참조하세요.

COlePropertiesDialog::m_lp

OLE 개체 속성 대화 상자의 링크 페이지를 초기화하는 데 사용되는 OLEUILINKPROPS 형식의 구조체입니다.

OLEUILINKPROPS m_lp;

설명

이 페이지에는 연결된 항목의 위치가 표시되며 사용자가 항목에 대한 링크를 업데이트하거나 끊을 수 있습니다.

구조에 OLEUILINKPROPS 대한 자세한 내용은 Windows SDK를 참조하세요.

COlePropertiesDialog::m_op

일반적인 OLE 개체 속성 대화 상자를 초기화하는 데 사용되는 OLEUIOBJECTPROPS 형식의 구조체입니다.

OLEUIOBJECTPROPS m_op;

설명

이 구조에는 일반, 링크 및 보기 페이지를 초기화하는 데 사용되는 멤버가 포함됩니다.

자세한 내용은 Windows SDK의 OLEUIOBJECTPROPS 및 OLEUILINKPROPS 구조를 참조하세요.

COlePropertiesDialog::m_psh

멤버가 대화 상자 개체의 특성을 저장하는 PROPSHEETHEADER 형식의 구조체입니다.

PROPSHEETHEADER m_psh;

설명

개체를 생성한 COlePropertiesDialog 후 멤버 함수를 호출 DoModal 하기 전에 대화 상자의 다양한 측면을 설정하는 데 사용할 m_psh 수 있습니다.

데이터 멤버를 m_psh 직접 수정하는 경우 기본 동작을 재정의합니다.

구조에 PROPSHEETHEADER 대한 자세한 내용은 Windows SDK를 참조하세요.

COlePropertiesDialog::m_vp

OLE 개체 속성 대화 상자의 보기 페이지를 초기화하는 데 사용되는 OLEUIVIEWPROPS 형식의 구조체입니다.

OLEUIVIEWPROPS m_vp;

설명

이 페이지에서는 사용자가 개체의 "콘텐츠"와 "아이콘" 보기 간에 전환하고 컨테이너 내에서 크기 조정을 변경할 수 있습니다. 또한 개체가 아이콘으로 표시될 때 사용자가 아이콘 변경 대화 상자에 액세스할 수 있습니다.

구조에 OLEUIVIEWPROPS 대한 자세한 내용은 Windows SDK를 참조하세요.

COlePropertiesDialog::OnApplyScale

크기 조정 값이 변경되고 확인 또는 적용이 선택되었을 때 프레임워크에서 호출됩니다.

virtual BOOL OnApplyScale(
    COleClientItem* pItem,
    int nCurrentScale,
    BOOL bRelativeToOrig);

매개 변수

pItem
속성에 액세스하는 문서 항목에 대한 포인터입니다.

nCurrentScale
대화 상자 눈금의 숫자 값입니다.

bRelativeToOrig
크기 조정이 문서 항목의 원래 크기에 적용되는지 여부를 나타냅니다.

Return Value

처리되는 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

기본 구현은 아무 작업도 수행하지 않습니다. 크기 조정 컨트롤을 사용하도록 설정하려면 이 함수를 재정의해야 합니다.

참고 항목

일반적인 OLE 개체 속성 대화 상자가 표시되기 전에 프레임워크는 pItem의 경우 NULL, nCurrentScale의 경우 - 1을 사용하여 이 함수를 호출합니다. 이 작업은 크기 조정 컨트롤을 사용하도록 설정해야 하는지 여부를 결정하기 위해 수행됩니다.

참고 항목

MFC 샘플 CIRC
COleDialog 클래스
계층 구조 차트
COleDialog 클래스
CPropertyPage 클래스