비고
MFC(Microsoft Foundation Classs) 라이브러리는 계속 지원됩니다. 그러나 더 이상 기능을 추가하거나 설명서를 업데이트하지 않습니다.
액티브 문서 포함을 구현합니다.
구문
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처리됩니다.
메뉴 병합 및 활성 문서 활성화에 대한 자세한 내용은 활성 문서 포함 개요 를 참조하세요.
상속 계층 구조
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에 전달된 명령은 그룹에 속해야 합니다.
반환 값
성공하면 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;
반환 값
현재 활성 보기의 IOleDocumentView 인터페이스에 대한 포인터입니다. 현재 보기가 없으면 NULL을 반환합니다.
설명
반환 IOleDocumentView 된 포인터의 참조 수는 이 함수에서 반환되기 전에 증가하지 않습니다.
COleDocObjectItem::GetPageCount
이 멤버 함수를 호출하여 문서의 페이지 수를 검색합니다.
BOOL GetPageCount(
LPLONG pnFirstPage,
LPLONG pcPages);
매개 변수
pnFirstPage
문서의 첫 번째 페이지 수에 대한 포인터입니다. 호출자에게 이 번호가 필요하지 않음을 나타내는 NULL일 수 있습니다.
pcPages
문서의 총 페이지 수에 대한 포인터입니다. 호출자에게 이 번호가 필요하지 않음을 나타내는 NULL일 수 있습니다.
반환 값
성공하면 0이 아니고, 그렇지 않으면 0입니다.
COleDocObjectItem::OnPreparePrinting
이 멤버 함수는 인쇄할 문서를 준비하기 위해 프레임워크에서 호출됩니다.
static BOOL OnPreparePrinting(
CView* pCaller,
CPrintInfo* pInfo,
BOOL bPrintAll = TRUE);
매개 변수
pCaller
인쇄 명령을 보내는 CView 개체에 대한 포인터입니다.
pInfo
인쇄할 작업을 설명하는 CPrintInfo 개체에 대한 포인터입니다.
bPrintAll
전체 문서를 인쇄할지 여부를 지정합니다.
반환 값
성공하면 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이 되어 표준 그룹을 지정할 수 있습니다.
반환 값
반환 값의 전체 목록은 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 클래스