COleDocObjectItem 클래스

액티브 문서 포함을 구현합니다.

구문

class COleDocObjectItem : public COleClientItem

멤버

공용 생성자

속성	설명
COleDocObjectItem::COleDocObjectItem	항목을 생성합니다 COleDocObject .

공용 메서드

이름	설명
COleDocObjectItem::D oDefaultPrinting	기본 프린터 설정을 사용하여 컨테이너 응용 프로그램의 문서를 인쇄합니다.
COleDocObjectItem::ExecCommand	사용자가 지정한 명령을 실행합니다.
COleDocObjectItem::GetActiveView	문서의 현재 보기를 검색합니다.
COleDocObjectItem::GetPageCount	컨테이너 애플리케이션의 문서에 있는 페이지 수를 검색합니다.
COleDocObjectItem::OnPreparePrinting	인쇄할 컨테이너 응용 프로그램의 문서를 준비합니다.
COleDocObjectItem::OnPrint	컨테이너 애플리케이션의 문서를 인쇄합니다.
COleDocObjectItem::QueryCommand	사용자 인터페이스 이벤트에 의해 생성되는 하나 이상 명령의 상태를 쿼리합니다.
COleDocObjectItem::Release	OLE 연결된 항목에 대한 연결을 해제하고 열려 있는 경우 닫습니다. 클라이언트 항목을 삭제하지 않습니다.

설명

MFC에서 활성 문서는 다음과 같은 차이점이 있는 일반 편집 가능한 포함과 유사하게 처리됩니다.

• -derived 클래스는 COleDocument현재 포함된 항목의 목록을 유지 관리합니다. 그러나 이러한 항목은 -derived 항목일 COleDocObjectItem수 있습니다.

• 현재 문서가 활성 상태이면 현재 위치 활성 상태일 때 보기의 전체 클라이언트 영역을 차지합니다.

• 활성 문서 컨테이너는 도움말 메뉴를 완전히 제어할 수 있습니다.

• 도움말 메뉴에는 활성 문서 컨테이너와 서버 모두에 대한 메뉴 항목이 포함되어 있습니다.

활성 문서 컨테이너는 도움말 메뉴를 소유하므로 컨테이너는 서버에 서버 도움말 메뉴 메시지를 전달합니다. 이 통합은 .에 의해 COleDocObjectItem처리됩니다.

메뉴 병합 및 활성 문서 활성화에 대한 자세한 내용은 활성 문서 포함 개요 를 참조하세요.

상속 계층 구조

CObject

CCmdTarget

CDocItem

COleClientItem

COleDocObjectItem

요구 사항

헤더: afxole.h

COleDocObjectItem::COleDocObjectItem

이 멤버 함수를 호출하여 개체를 초기화합니다 COleDocObjectItem .

COleDocObjectItem(COleDocument* pContainerDoc = NULL);

매개 변수

pContainerDoc
현재 문서 컨테이너 역할을 하는 개체에 대한 포인터 COleDocument 입니다. IMPLEMENT_SERIALIZE 사용하려면 이 매개 변수가 NULL이어야 합니다. 일반적으로 OLE 항목은 NULL이 아닌 문서 포인터를 사용하여 생성됩니다.

COleDocObjectItem::D oDefaultPrinting

기본 설정을 사용하여 프레임워크에서 문서로 호출됩니다.

static HRESULT DoDefaultPrinting(
    CView* pCaller,
    CPrintInfo* pInfo);

매개 변수

pCaller
인쇄 명령을 보내는 CView 개체에 대한 포인터입니다.

pInfo
인쇄할 작업을 설명하는 CPrintInfo 개체에 대한 포인터입니다.

COleDocObjectItem::ExecCommand

이 멤버 함수를 호출하여 사용자가 지정한 명령을 실행합니다.

HRESULT ExecCommand(
    DWORD nCmdID,
    DWORD nCmdExecOpt = OLECMDEXECOPT_DONTPROMPTUSER,
    const GUID* pguidCmdGroup = NULL);

매개 변수

nCmdID
실행할 명령의 식별자입니다. pguidCmdGroup으로 식별되는 그룹에 있어야 합니다.

nCmdExecOpt
명령 실행 옵션을 지정합니다. 기본적으로 사용자에게 메시지를 표시하지 않고 명령을 실행하도록 설정합니다. 값 목록은 OLECMDEXECOPT를 참조하세요.

pguidCmdGroup
명령 그룹의 고유 식별자입니다. 기본적으로 표준 그룹을 지정하는 NULL입니다. nCmdID에 전달된 명령은 그룹에 속해야 합니다.

Return Value

성공하면 S_OK 반환합니다. 그렇지 않으면 다음 오류 코드 중 하나를 반환합니다.

값	설명
E_UNEXPECTED	예기치 않은 오류가 발생했습니다.
E_FAIL	오류가 발생했습니다.
E_NOTIMPL	MFC 자체가 명령을 번역하고 디스패치하려고 시도해야 했음을 나타냅니다.
OLECMDERR_E_UNKNOWNGROUP	pguidCmdGroup 은 NULL이 아니지만 인식된 명령 그룹을 지정하지 않습니다.
OLECMDERR_E_NOTSUPPORTED	nCmdID 는 그룹 pGroup에서 유효한 명령으로 인식되지 않습니다.
OLECMDERR_DISABLED	nCmdID로 식별된 명령이 비활성화되어 실행될 수 없습니다.
OLECMDERR_NOHELP	호출자가 nCmdID로 식별된 명령에 대한 도움을 요청했지만 사용할 수 있는 도움말은 없습니다.
OLECMDERR_CANCELLED	사용자가 실행을 취소했습니다.

설명

pguidCmdGroup과 nCmdID 매개 변수는 함께 호출할 명령을 고유하게 식별합니다. nCmdExecOpt 매개 변수는 수행할 정확한 작업을 지정합니다.

COleDocObjectItem::GetActiveView

이 멤버 함수를 호출하여 현재 활성 뷰의 IOleDocumentView 인터페이스에 대한 포인터를 가져옵니다.

LPOLEDOCUMENTVIEW GetActiveView() const;

Return Value

현재 활성 보기의 IOleDocumentView 인터페이스에 대한 포인터입니다. 현재 보기가 없으면 NULL을 반환합니다.

설명

반환 IOleDocumentView 된 포인터의 참조 수는 이 함수에서 반환되기 전에 증가하지 않습니다.

COleDocObjectItem::GetPageCount

이 멤버 함수를 호출하여 문서의 페이지 수를 검색합니다.

BOOL GetPageCount(
    LPLONG pnFirstPage,
    LPLONG pcPages);

매개 변수

pnFirstPage
문서의 첫 번째 페이지 수에 대한 포인터입니다. 호출자에게 이 번호가 필요하지 않음을 나타내는 NULL일 수 있습니다.

pcPages
문서의 총 페이지 수에 대한 포인터입니다. 호출자에게 이 번호가 필요하지 않음을 나타내는 NULL일 수 있습니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

COleDocObjectItem::OnPreparePrinting

이 멤버 함수는 인쇄할 문서를 준비하기 위해 프레임워크에서 호출됩니다.

static BOOL OnPreparePrinting(
    CView* pCaller,
    CPrintInfo* pInfo,
    BOOL bPrintAll = TRUE);

매개 변수

pCaller
인쇄 명령을 보내는 CView 개체에 대한 포인터입니다.

pInfo
인쇄할 작업을 설명하는 CPrintInfo 개체에 대한 포인터입니다.

bPrintAll
전체 문서를 인쇄할지 여부를 지정합니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

COleDocObjectItem::OnPrint

이 멤버 함수는 문서를 인쇄하기 위해 프레임워크에서 호출됩니다.

static void OnPrint(
    CView* pCaller,
    CPrintInfo* pInfo,
    BOOL bPrintAll = TRUE);

매개 변수

pCaller
인쇄 명령을 보내는 CView 개체에 대한 포인터입니다.

pInfo
인쇄할 작업을 설명하는 CPrintInfo 개체에 대한 포인터입니다.

bPrintAll
전체 문서를 인쇄할지 여부를 지정합니다.

COleDocObjectItem::QueryCommand

사용자 인터페이스 이벤트에 의해 생성되는 하나 이상 명령의 상태를 쿼리합니다.

HRESULT QueryCommand(
    ULONG nCmdID,
    DWORD* pdwStatus,
    OLECMDTEXT* pCmdText =NULL,
    const GUID* pguidCmdGroup =NULL);

매개 변수

nCmdID
쿼리할 명령의 식별자입니다.

pdwStatus
쿼리의 결과로 반환된 플래그에 대한 포인터입니다. 가능한 값 목록은 OLECMDF를 참조하세요.

pCmdText
단일 명령에 대한 이름 및 상태 정보를 반환할 OLECMDTEXT 구조체에 대한 포인터입니다. 호출자에게 이 정보가 필요하지 않음을 나타내는 NULL일 수 있습니다.

pguidCmdGroup
명령 그룹의 고유 식별자입니다. 은 NULL이 되어 표준 그룹을 지정할 수 있습니다.

Return Value

반환 값의 전체 목록은 Windows SDK의 IOleCommandTarget::QueryStatus를 참조하세요.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 IOleCommandTarget::QueryStatus 메서드의 기능을 에뮬레이트합니다.

COleDocObjectItem::Release

OLE 연결된 항목에 대한 연결을 해제하고 열려 있는 경우 닫습니다. 클라이언트 항목을 삭제하지 않습니다.

virtual void Release(OLECLOSE dwCloseOption = OLECLOSE_NOSAVE);

매개 변수

dwCloseOption
OLE 항목이 로드된 상태로 반환될 때 저장되는 상황에서 지정하는 플래그입니다. 가능한 값 목록은 COleClientItem::Close를 참조 하세요.

설명

클라이언트 항목을 삭제하지 않습니다.

참고 항목

MFC 샘플 MFCBIND
COleClientItem 클래스
계층 구조 차트
COleClientItem 클래스
CDocObjectServerItem 클래스