다음을 통해 공유


CDocTemplate 클래스

문서 템플릿의 기본 기능을 정의하는 추상 기본 클래스입니다.

구문

class CDocTemplate : public CCmdTarget

멤버

보호된 생성자

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

공용 메서드

이름 설명
CDocTemplate::AddDocument 서식 파일에 문서를 추가합니다.
CDocTemplate::CloseAllDocuments 이 템플릿과 연결된 모든 문서를 닫습니다.
CDocTemplate::CreateNewDocument 새 문서를 만듭니다.
CDocTemplate::CreateNewFrame 문서와 뷰를 포함하는 새 프레임 창을 만듭니다.
CDocTemplate::CreateOleFrame OLE 사용 프레임 창을 만듭니다.
CDocTemplate::CreatePreviewFrame 리치 미리 보기에 사용되는 자식 프레임을 만듭니다.
CDocTemplate::GetDocString 문서 형식과 연결된 문자열을 검색합니다.
CDocTemplate::GetFirstDocPosition 이 서식 파일과 연결된 첫 번째 문서의 위치를 검색합니다.
CDocTemplate::GetNextDoc 문서와 다음 문서의 위치를 검색합니다.
CDocTemplate::InitialUpdateFrame 프레임 창을 초기화하고 필요에 따라 표시합니다.
CDocTemplate::LoadTemplate 지정된 CDocTemplate 클래스 또는 파생 클래스에 대한 리소스를 로드합니다.
CDocTemplate::MatchDocType 문서 형식과 이 서식 파일 간의 일치에 대한 신뢰도를 결정합니다.
CDocTemplate::OpenDocumentFile 경로 이름으로 지정된 파일을 엽니다.
CDocTemplate::RemoveDocument 서식 파일에서 문서를 제거합니다.
CDocTemplate::SaveAllModified 수정된 이 템플릿과 연결된 모든 문서를 저장합니다.
CDocTemplate::SetContainerInfo 현재 위치 OLE 항목을 편집할 때 OLE 컨테이너에 대한 리소스를 결정합니다.
CDocTemplate::SetDefaultTitle 문서 창의 제목 표시줄에 기본 제목을 표시합니다.
CDocTemplate::SetPreviewInfo 프로세스 외부 미리 보기 처리기를 설치합니다.
CDocTemplate::SetServerInfo 서버 문서가 현재 위치에 포함되거나 편집될 때 리소스 및 클래스를 결정합니다.

설명

일반적으로 애플리케이션 InitInstance 의 함수 구현에서 하나 이상의 문서 템플릿을 만듭니다. 문서 템플릿은 세 가지 유형의 클래스 간의 관계를 정의합니다.

  • 에서 파생 CDocument되는 문서 클래스입니다.

  • 위에 나열된 문서 클래스의 데이터를 표시하는 뷰 클래스입니다. 이 클래스는 , CScrollView또는 CFormViewCEditView.에서 CView파생할 수 있습니다. (직접 사용할 CEditView 수도 있습니다.)

  • 보기를 포함하는 프레임 창 클래스입니다. 단일 SDI(문서 인터페이스) 애플리케이션의 경우 이 클래스를 .에서 CFrameWnd파생합니다. MDI(다중 문서 인터페이스) 애플리케이션의 경우 이 클래스를 .에서 CMDIChildWnd파생합니다. 프레임 창의 동작을 사용자 지정할 필요가 없는 경우 고유한 클래스를 파생하지 않고 직접 사용하거나 CMDIChildWnd 직접 사용할 CFrameWnd 수 있습니다.

애플리케이션에는 지원하는 각 문서 유형에 대해 하나의 문서 서식 파일이 있습니다. 예를 들어 애플리케이션이 스프레드시트와 텍스트 문서를 모두 지원하는 경우 애플리케이션에는 두 개의 문서 템플릿 개체가 있습니다. 각 문서 서식 파일은 해당 형식의 모든 문서를 만들고 관리하는 역할을 담당합니다.

문서 서식 파일은 문서, 보기 및 프레임 창 클래스의 개체에 대한 포인터 CRuntimeClass 를 저장합니다. 이러한 CRuntimeClass 개체는 문서 서식 파일을 생성할 때 지정됩니다.

문서 서식 파일에는 문서 유형(예: 메뉴, 아이콘 또는 액셀러레이터 테이블 리소스)과 함께 사용되는 리소스의 ID가 포함되어 있습니다. 문서 서식 파일에는 문서 형식에 대한 추가 정보가 포함된 문자열도 있습니다. 여기에는 문서 형식의 이름(예: "워크시트") 및 파일 확장명(예: ".xls")이 포함됩니다. 필요에 따라 애플리케이션의 사용자 인터페이스, Windows 파일 관리자 및 OLE(개체 연결 및 포함) 지원에서 사용하는 다른 문자열을 포함할 수 있습니다.

애플리케이션이 OLE 컨테이너 및/또는 서버인 경우 문서 템플릿은 현재 위치 활성화 중에 사용되는 메뉴의 ID도 정의합니다. 애플리케이션이 OLE 서버인 경우 문서 템플릿은 현재 위치 활성화 중에 사용되는 도구 모음 및 메뉴의 ID를 정의합니다. 호출 SetContainerInfo 하여 이러한 추가 OLE 리소스를 지정합니다 SetServerInfo.

CDocTemplate 추상 클래스이므로 클래스를 직접 사용할 수 없습니다. 일반적인 애플리케이션은 Microsoft Foundation 클래스 라이브러리CSingleDocTemplate에서 제공하는 두 CDocTemplate가지 파생 클래스 중 하나를 사용합니다. 즉, SDI를 구현하고 CMultiDocTemplateMDI를 구현합니다. 문서 서식 파일 사용에 대한 자세한 내용은 해당 클래스를 참조하세요.

애플리케이션에 SDI 또는 MDI와 근본적으로 다른 사용자 인터페이스 패러다임이 필요한 경우 사용자 고유의 클래스 CDocTemplate를 파생시킬 수 있습니다.

자세한 내용은 CDocTemplate문서 서식 파일 및 문서/보기 만들기 프로세스를 참조 하세요.

상속 계층 구조

CObject

CCmdTarget

CDocTemplate

요구 사항

헤더afxwin.h:

CDocTemplate::AddDocument

이 함수를 사용하여 서식 파일에 문서를 추가합니다.

virtual void AddDocument(CDocument* pDoc);

매개 변수

pDoc
추가할 문서에 대한 포인터입니다.

설명

파생 클래스이며 CMultiDocTemplateCSingleDocTemplate 이 함수를 재정의합니다. 사용자 고유의 문서 템플릿 클래스를 CDocTemplate파생하는 경우 파생 클래스가 이 함수를 재정의해야 합니다.

CDocTemplate::CDocTemplate

CDocTemplate 개체를 생성합니다.

CDocTemplate (
    UINT nIDResource,
    CRuntimeClass* pDocClass,
    CRuntimeClass* pFrameClass,
    CRuntimeClass* pViewClass);

매개 변수

nIDResource
문서 형식에 사용되는 리소스의 ID를 지정합니다. 여기에는 메뉴, 아이콘, 액셀러레이터 테이블 및 문자열 리소스가 포함될 수 있습니다.

문자열 리소스는 문자로 \n 구분된 최대 7개의 부분 문자열로 구성됩니다( \n 부분 문자열이 포함되지 않은 경우 문자가 자리 표시자로 필요함, 그러나 후행 \n 문자는 필요하지 않음). 이러한 부분 문자열은 문서 형식을 설명합니다. 부분 문자열에 대한 자세한 내용은 다음을 참조하세요 GetDocString. 이 문자열 리소스는 애플리케이션의 리소스 파일에서 찾을 수 있습니다. 예시:

// MYCALC.RC
STRINGTABLE PRELOAD DISCARDABLE
BEGIN
  IDR_SHEETTYPE "\nSheet\nWorksheet\nWorksheets (*.myc)\n.myc\n MyCalcSheet\nMyCalc Worksheet"
END

문자열은 문자로 \n 시작합니다. 이는 첫 번째 부분 문자열이 MDI 애플리케이션에 사용되지 않으므로 포함되지 않기 때문입니다. 문자열 편집기를 사용하여 이 문자열을 편집할 수 있습니다. 전체 문자열은 7개의 개별 항목이 아니라 문자열 편집기에서 단일 항목으로 나타납니다.

pDocClass
문서 클래스의 CRuntimeClass 개체를 가리킵니다. 이 클래스는 CDocument문서를 나타내기 위해 정의하는 파생 클래스입니다.

pFrameClass
CRuntimeClass 프레임 창 클래스의 개체를 가리킵니다. 이 클래스는 CFrameWnd파생 클래스이거나 기본 프레임 창에 대한 기본 동작을 원하는 경우 자체일 CFrameWnd 수 있습니다.

pViewClass
뷰 클래스의 CRuntimeClass 개체를 가리킵니다. 이 클래스는 CView문서를 표시하기 위해 정의하는 파생 클래스입니다.

설명

이 멤버 함수를 사용하여 개체를 생성합니다 CDocTemplate . 개체를 CDocTemplate 동적으로 할당하고 애플리케이션 클래스의 InitInstance 멤버 함수에서 전달 CWinApp::AddDocTemplate 합니다.

CDocTemplate::CloseAllDocuments

이 멤버 함수를 호출하여 열려 있는 모든 문서를 닫습니다.

virtual void CloseAllDocuments(BOOL bEndSession);

매개 변수

bEndSession
사용되지 않습니다.

설명

이 멤버 함수는 일반적으로 파일 종료 명령의 일부로 사용됩니다. 이 함수의 기본 구현에서는 멤버 함수를 호출 CDocument::DeleteContents 하여 문서의 데이터를 삭제한 다음 문서에 연결된 모든 보기의 프레임 창을 닫습니다.

문서를 닫기 전에 사용자가 특수 클린업 처리를 수행하도록 요구하려면 이 함수를 재정의합니다. 예를 들어 문서가 데이터베이스의 레코드를 나타내는 경우 이 함수를 재정의하여 데이터베이스를 닫을 수 있습니다.

CDocTemplate::CreateNewDocument

이 멤버 함수를 호출하여 이 문서 서식 파일과 연결된 형식의 새 문서를 만듭니다.

virtual CDocument* CreateNewDocument();

Return Value

새로 만든 문서에 대한 포인터이거나 NULL 오류가 발생하는 경우

CDocTemplate::CreateNewFrame

문서와 뷰를 포함하는 새 프레임 창을 만듭니다.

virtual CFrameWnd* CreateNewFrame(
    CDocument* pDoc,
    CFrameWnd* pOther);

매개 변수

pDoc
새 프레임 창이 참조해야 하는 문서입니다. NULL일 수 있습니다.

pOther
새 프레임 창을 기반으로 하는 프레임 창입니다. NULL일 수 있습니다.

Return Value

새로 만든 프레임 창에 대한 포인터이거나 NULL 오류가 발생하는 경우

설명

CreateNewFrameCRuntimeClass 생성자에 전달된 개체를 사용하여 뷰와 문서가 연결된 새 프레임 창을 만듭니다. 매개 변수인 pDocNULL경우 프레임워크는 메시지를 출력합니다 TRACE .

pOther 매개 변수는 Window New 명령을 구현하는 데 사용됩니다. 새 프레임 창을 모델링할 프레임 창을 제공합니다. 새 프레임 창은 일반적으로 보이지 않게 만들어집니다. 이 함수를 호출하여 파일 새로 만들기 및 파일 열기의 표준 프레임워크 구현 외부에서 프레임 창을 만듭니다.

CDocTemplate::CreateOleFrame

OLE 프레임 창을 만듭니다.

CFrameWnd* CreateOleFrame(
    CWnd* pParentWnd,
    CDocument* pDoc,
    BOOL bCreateView);

매개 변수

pParentWnd
프레임의 부모 창에 대한 포인터입니다.

pDoc
새 OLE 프레임 창이 참조해야 하는 문서에 대한 포인터입니다.

bCreateView
뷰가 프레임과 함께 생성되는지 여부를 결정합니다.

Return Value

성공하면 프레임 창에 대한 포인터입니다. 그렇지 않으면 NULL.

설명

0이면 bCreateView 빈 프레임이 만들어집니다.

CDocTemplate::GetDocString

문서 형식과 연결된 문자열을 검색합니다.

virtual BOOL GetDocString(
    CString& rString,
    enum DocStringIndex index) const;

매개 변수

rString
함수가 CString 반환될 때 문자열을 포함할 개체에 대한 참조입니다.

index
문서 형식을 설명하는 문자열에서 검색되는 부분 문자열의 인덱스입니다. 이 매개 변수는 다음 값 중 하나를 가질 수 있습니다.

  • CDocTemplate::windowTitle 응용 프로그램 창의 제목 표시줄에 표시되는 이름(예: "Microsoft Excel"). SDI 애플리케이션에 대한 문서 템플릿에만 표시됩니다.

  • CDocTemplate::docName 기본 문서 이름(예: "Sheet")의 루트입니다. 이 루트와 숫자는 사용자가 [파일] 메뉴에서 [새] 명령을 선택할 때마다 이 형식의 새 문서의 기본 이름에 사용됩니다(예: "Sheet1" 또는 "Sheet2"). 지정하지 않으면 "제목 없음"이 기본값으로 사용됩니다.

  • CDocTemplate::fileNewName 이 문서 형식의 이름입니다. 애플리케이션에서 두 개 이상의 문서 형식을 지원하는 경우 이 문자열은 [파일 새로 만들기] 대화 상자(예: "워크시트")에 표시됩니다. 지정하지 않으면 [파일 새로 만들기] 명령을 사용하여 문서 형식에 액세스할 수 없습니다.

  • CDocTemplate::filterName이 형식의 문서 형식 및 와일드카드 필터 일치 문서에 대한 설명입니다. 이 문자열은 파일 열기 대화 상자의 형식 목록 드롭다운 목록에 표시됩니다(예: "워크시트(*.xls)"). 지정하지 않으면 파일 열기 명령을 사용하여 문서 형식에 액세스할 수 없습니다.

  • CDocTemplate::filterExt 이 형식의 문서에 대한 확장명(예: ".xls"). 지정하지 않으면 파일 열기 명령을 사용하여 문서 형식에 액세스할 수 없습니다.

  • CDocTemplate::regFileTypeIdWindows에서 기본 등록 데이터베이스에 저장할 문서 형식의 식별자입니다. 이 문자열은 내부용으로만 사용됩니다(예: "ExcelWorksheet"). 지정하지 않으면 문서 유형을 Windows 파일 관리자에 등록할 수 없습니다.

  • CDocTemplate::regFileTypeName 등록 데이터베이스에 저장할 문서 형식의 이름입니다. 이 문자열은 등록 데이터베이스에 액세스하는 애플리케이션의 대화 상자에 표시될 수 있습니다(예: "Microsoft Excel 워크시트").

Return Value

지정된 부분 문자열을 찾은 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

문서 형식을 설명하는 특정 부분 문자열을 검색하려면 이 함수를 호출합니다. 이러한 부분 문자열을 포함하는 문자열은 문서 템플릿에 저장되며 애플리케이션에 대한 리소스 파일의 문자열에서 파생됩니다. 프레임워크는 이 함수를 호출하여 애플리케이션의 사용자 인터페이스에 필요한 문자열을 가져옵니다. 애플리케이션 문서에 대한 파일 이름 확장 프로그램을 지정한 경우 Windows 등록 데이터베이스에 항목을 추가할 때 프레임워크에서 이 함수를 호출합니다. 이렇게 하면 Windows 파일 관리자에서 문서를 열 수 있습니다.

에서 고유한 클래스 CDocTemplate를 파생하는 경우에만 이 함수를 호출합니다.

CDocTemplate::GetFirstDocPosition

이 서식 파일과 연결된 첫 번째 문서의 위치를 검색합니다.

virtual POSITION GetFirstDocPosition() const = 0;

Return Value

POSITION 이 문서 서식 파일과 연결된 문서 목록을 반복하거나 NULL 목록이 비어 있는 경우 반복하는 데 사용할 수 있는 값입니다.

설명

이 함수를 사용하여 이 서식 파일과 연결된 문서 목록에서 첫 번째 문서의 위치를 가져옵니다. POSITION 이 값을 인수 CDocTemplate::GetNextDoc 로 사용하여 템플릿과 연결된 문서 목록을 반복합니다.

CSingleDocTemplateCMultiDocTemplate 다 이 순수 가상 함수를 재정의합니다. 파생되는 CDocTemplate 모든 클래스도 이 함수를 재정의해야 합니다.

CDocTemplate::GetNextDoc

식별된 목록 요소를 검색한 rPos다음 목록에서 다음 항목의 값으로 설정합니다 rPosPOSITION .

virtual CDocument* GetNextDoc(POSITION& rPos) const = 0;

Return Value

이 서식 파일과 연결된 문서 목록의 다음 문서에 대한 포인터입니다.

매개 변수

rPos
이전 호출 GetFirstDocPosition 에서 반환한 값에 대한 참조 POSITION 입니다GetNextDoc.

설명

검색된 요소가 목록의 마지막 요소이면 새 값 rPos 이 로 설정 NULL됩니다.

호출을 사용하여 초기 위치를 설정하는 경우 정방향 반복 루프에서 사용할 GetNextDoc 수 있습니다 GetFirstDocPosition.

값이 POSITION 목록에서 유효한 위치를 나타내는지 확인해야 합니다. 잘못된 경우 Microsoft Foundation 클래스 라이브러리의 디버그 버전이 어설션됩니다.

CDocTemplate::InitialUpdateFrame

프레임 창을 초기화하고 필요에 따라 표시합니다.

virtual void InitialUpdateFrame(
    CFrameWnd* pFrame,
    CDocument* pDoc,
    BOOL bMakeVisible = TRUE);

매개 변수

pFrame
초기 업데이트가 필요한 프레임 창입니다.

pDoc
프레임이 연결된 문서입니다. NULL일 수 있습니다.

bMakeVisible
프레임이 표시되고 활성화되어야 하는지 여부를 나타냅니다.

설명

를 사용하여 새 프레임CreateNewFrame을 만든 후 호출 IntitialUpdateFrame 합니다. 이 함수를 호출하면 해당 프레임 창의 뷰가 호출을 받습니다 OnInitialUpdate . 또한 이전에 활성 보기가 없으면 프레임 창의 기본 보기가 활성화됩니다. 기본 보기는 자식 ID가 .인 AFX_IDW_PANE_FIRST보기입니다. 마지막으로 0이 아닌 경우 bMakeVisible 프레임 창이 표시됩니다. 0이면 bMakeVisible 프레임 창의 현재 포커스와 표시 상태가 변경되지 기본.

파일 새로 만들기 및 파일 열기의 프레임워크 구현을 사용할 때는 이 함수를 호출할 필요가 없습니다.

CDocTemplate::LoadTemplate

지정된 CDocTemplate 클래스 또는 파생 클래스에 대한 리소스를 로드합니다.

virtual void LoadTemplate();

설명

이 멤버 함수는 지정된 CDocTemplate 클래스 또는 파생 클래스에 대한 리소스를 로드하기 위해 프레임워크에서 호출됩니다. 일반적으로 템플릿이 전역적으로 생성되는 경우를 제외하고 생성 중에 호출됩니다. 이 경우 호출이 LoadTemplate 호출될 때까지 CWinApp::AddDocTemplate 지연됩니다.

CDocTemplate::MatchDocType

문서 형식과 이 서식 파일 간의 일치에 대한 신뢰도를 결정합니다.

virtual Confidence MatchDocType(
    LPCTSTR lpszPathName,
    CDocument*& rpDocMatch);

매개 변수

lpszPathName
형식을 확인할 파일의 경로 이름입니다.

rpDocMatch
지정한 파일이 이미 열려 있는 경우 일치하는 문서가 할당된 문서에 대한 lpszPathName 포인터입니다.

Return Value

다음과 같이 정의된 열거형의 값 Confidence 입니다.

enum Confidence
    {
    noAttempt,
    maybeAttemptForeign,
    maybeAttemptNative,
    yesAttemptForeign,
    yesAttemptNative,
    yesAlreadyOpen
    };

설명

이 함수를 사용하여 파일을 여는 데 사용할 문서 서식 파일의 형식을 결정합니다. 예를 들어 애플리케이션에서 여러 파일 형식을 지원하는 경우 이 함수를 사용하여 각 템플릿을 차례로 호출 MatchDocType 하고 반환된 신뢰도 값에 따라 템플릿을 선택하여 지정된 파일에 적합한 사용 가능한 문서 서식 파일을 확인할 수 있습니다.

지정한 lpszPathName 파일이 이미 열려 있는 경우 이 함수는 파일의 CDocument 개체를 반환 CDocTemplate::yesAlreadyOpen 하여 개체rpDocMatch에 복사합니다.

파일이 열려 있지 않지만 확장 lpszPathName 이 지정한 CDocTemplate::filterExt확장과 일치하는 경우 이 함수는 반환 CDocTemplate::yesAttemptNative 하고 설정합니다 rpDocMatchNULL. CDocTemplate::filterExt에 대한 자세한 내용은 CDocTemplate::GetDocString를 참조하세요.

두 경우 모두 true가 아니면 함수가 반환됩니다 CDocTemplate::yesAttemptForeign.

기본 구현이 반환 CDocTemplate::maybeAttemptForeignCDocTemplate::maybeAttemptNative되지 않거나 . 열거형에서 이러한 두 값을 사용하여 애플리케이션에 적합한 형식 일치 논리를 구현하도록 이 함수를 재정의 Confidence 합니다.

CDocTemplate::OpenDocumentFile

경로로 지정된 파일을 엽니다.

virtual CDocument* OpenDocumentFile(LPCTSTR lpszPathName) = 0;

virtual CDocument* OpenDocumentFile(
    LPCTSTR lpszPathName,
    BOOL bAddToMRU) = 0;

매개 변수

lpszPathName
[in] 열 문서가 포함된 파일의 경로에 대한 포인터입니다.

bAddToMRU
[in] TRUE 은 문서가 가장 최근 파일 중 하나임을 나타냅니다. FALSE 은 문서가 최신 파일 중 하나가 아님을 나타냅니다.

Return Value

파일 이름이 ;(실패하면) NULL 인 문서에 대한 포인터입니다lpszPathName.

설명

경로가 .로 지정된 lpszPathName파일을 엽니다. 이 NULL경우 lpszPathName 이 서식 파일과 연결된 형식의 문서가 포함된 새 파일이 만들어집니다.

CDocTemplate::RemoveDocument

이 서식 파일과 연결된 문서 목록에서 가리키는 pDoc 문서를 제거합니다.

virtual void RemoveDocument(CDocument* pDoc);

매개 변수

pDoc
제거할 문서에 대한 포인터입니다.

설명

파생 클래스이며 CMultiDocTemplateCSingleDocTemplate 이 함수를 재정의합니다. 사용자 고유의 문서 템플릿 클래스를 CDocTemplate파생하는 경우 파생 클래스가 이 함수를 재정의해야 합니다.

CDocTemplate::SaveAllModified

수정된 모든 문서를 저장합니다.

virtual BOOL SaveAllModified();

Return Value

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

CDocTemplate::SetContainerInfo

현재 위치 OLE 항목을 편집할 때 OLE 컨테이너에 대한 리소스를 결정합니다.

void SetContainerInfo(UINT nIDOleInPlaceContainer);

매개 변수

nIDOleInPlaceContainer
포함된 개체가 활성화될 때 사용되는 리소스의 ID입니다.

설명

OLE 개체가 현재 위치에서 활성화될 때 사용할 리소스를 설정하려면 이 함수를 호출합니다. 이러한 리소스에는 메뉴 및 액셀러레이터 테이블이 포함될 수 있습니다. 이 함수는 일반적으로 애플리케이션의 함수에서 CWinApp::InitInstance 호출됩니다.

연결된 nIDOleInPlaceContainer 메뉴에는 활성화된 현재 위치 항목의 메뉴를 컨테이너 애플리케이션의 메뉴와 병합할 수 있는 구분 기호가 포함되어 있습니다. 서버 및 컨테이너 메뉴 병합에 대한 자세한 내용은 OLE(메뉴 및 리소스) 문서를 참조하세요.

CDocTemplate::SetDefaultTitle

이 함수를 호출하여 문서의 기본 제목을 로드하고 문서의 제목 표시줄에 표시합니다.

virtual void SetDefaultTitle(CDocument* pDocument) = 0;

매개 변수

pDocument
제목을 설정할 문서에 대한 포인터입니다.

설명

기본 제목에 대한 자세한 내용은 에 대한 설명을 CDocTemplate::docName 참조하세요 CDocTemplate::GetDocString.

CDocTemplate::SetServerInfo

서버 문서가 현재 위치에 포함되거나 편집될 때 리소스 및 클래스를 결정합니다.

void SetServerInfo(
    UINT nIDOleEmbedding,
    UINT nIDOleInPlaceServer = 0,
    CRuntimeClass* pOleFrameClass = NULL,
    CRuntimeClass* pOleViewClass = NULL);

매개 변수

nIDOleEmbedding
포함된 개체가 별도의 창에서 열릴 때 사용되는 리소스의 ID입니다.

nIDOleInPlaceServer
포함된 개체가 현재 위치에서 활성화될 때 사용되는 리소스의 ID입니다.

pOleFrameClass
현재 위치 활성화가 CRuntimeClass 발생할 때 생성되는 프레임 창 개체에 대한 클래스 정보를 포함하는 구조체에 대한 포인터입니다.

pOleViewClass
현재 위치 활성화가 CRuntimeClass 발생할 때 생성된 뷰 개체에 대한 클래스 정보를 포함하는 구조체에 대한 포인터입니다.

설명

이 멤버 함수를 호출하여 사용자가 포함된 개체의 활성화를 요청할 때 서버 애플리케이션에서 사용할 리소스를 식별합니다. 이러한 리소스는 메뉴 및 액셀러레이터 테이블로 구성됩니다. 이 함수는 일반적으로 애플리케이션에서 InitInstance 호출됩니다.

연결된 nIDOleInPlaceServer 메뉴에는 서버 메뉴가 컨테이너 메뉴와 병합될 수 있도록 하는 구분 기호가 포함되어 있습니다. 서버 및 컨테이너 메뉴 병합에 대한 자세한 내용은 OLE(메뉴 및 리소스) 문서를 참조하세요.

CDocTemplate::CreatePreviewFrame

리치 미리 보기에 사용되는 자식 프레임을 만듭니다.

CFrameWnd* CreatePreviewFrame(
    CWnd* pParentWnd,
    CDocument* pDoc);

매개 변수

pParentWnd
부모 창에 대한 포인터입니다(일반적으로 셸에서 제공).

pDoc
콘텐츠를 미리 볼 문서 개체에 대한 포인터입니다.

Return Value

개체에 대한 유효한 포인터이거나 CFrameWnd , 생성에 실패하면 NULL입니다.

설명

CDocTemplate::SetPreviewInfo

Out of process 미리 보기 처리기를 설정합니다.

void SetPreviewInfo(
    UINT nIDPreviewFrame,
    CRuntimeClass* pPreviewFrameClass = NULL,
    CRuntimeClass* pPreviewViewClass = NULL);

매개 변수

nIDPreviewFrame
미리 보기 프레임의 리소스 ID를 지정합니다.

pPreviewFrameClass
미리 보기 프레임의 런타임 클래스 정보 구조에 대한 포인터를 지정합니다.

pPreviewViewClass
미리 보기의 런타임 클래스 정보 구조에 대한 포인터를 지정합니다.

설명

참고 항목

CCmdTarget 클래스
계층 구조 차트
CSingleDocTemplate 클래스
CMultiDocTemplate 클래스
CDocument 클래스
CView 클래스
CScrollView 클래스
CEditView 클래스
CFormView 클래스
CFrameWnd 클래스
CMDIChildWnd 클래스