CDocTemplate Klasa

Abstrakcyjna klasa bazowa, która definiuje podstawowe funkcje szablonów dokumentów.

Składnia

class CDocTemplate : public CCmdTarget

Elementy członkowskie

Konstruktory chronione

Nazwa/nazwisko	opis
CDocTemplate::CDocTemplate	CDocTemplate Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CDocTemplate::AddDocument	Dodaje dokument do szablonu.
CDocTemplate::CloseAllDocuments	Zamyka wszystkie dokumenty skojarzone z tym szablonem.
CDocTemplate::CreateNewDocument	Tworzy nowy dokument.
CDocTemplate::CreateNewFrame	Tworzy nowe okno ramki zawierające dokument i widok.
CDocTemplate::CreateOleFrame	Tworzy okno ramki z obsługą ole.
CDocTemplate::CreatePreviewFrame	Tworzy ramkę podrzędną używaną w wersji zapoznawczej Rich Preview.
CDocTemplate::GetDocString	Pobiera ciąg skojarzony z typem dokumentu.
CDocTemplate::GetFirstDocPosition	Pobiera pozycję pierwszego dokumentu skojarzonego z tym szablonem.
CDocTemplate::GetNextDoc	Pobiera dokument i położenie następnego.
CDocTemplate::InitialUpdateFrame	Inicjuje okno ramki i opcjonalnie sprawia, że jest widoczny.
CDocTemplate::LoadTemplate	Ładuje zasoby dla danej CDocTemplate klasy lub pochodnej.
CDocTemplate::MatchDocType	Określa stopień pewności dopasowania między typem dokumentu a tym szablonem.
CDocTemplate::OpenDocumentFile	Otwiera plik określony przez nazwę ścieżki.
CDocTemplate::RemoveDocument	Usuwa dokument z szablonu.
CDocTemplate::SaveAllModified	Zapisuje wszystkie dokumenty skojarzone z tym szablonem, które zostały zmodyfikowane.
CDocTemplate::SetContainerInfo	Określa zasoby dla kontenerów OLE podczas edytowania elementu OLE w miejscu.
CDocTemplate::SetDefaultTitle	Wyświetla domyślny tytuł na pasku tytułu okna dokumentu.
CDocTemplate::SetPreviewInfo	Konfiguruje program obsługi w wersji zapoznawczej procesu.
CDocTemplate::SetServerInfo	Określa zasoby i klasy, gdy dokument serwera jest osadzony lub edytowany w miejscu.

Uwagi

Zazwyczaj w implementacji funkcji aplikacji InitInstance tworzy się co najmniej jeden szablon dokumentów. Szablon dokumentu definiuje relacje między trzema typami klas:

• Klasa dokumentów, która pochodzi z klasy CDocument.

• Klasa widoku, która wyświetla dane z klasy dokumentów wymienionej powyżej. Tę klasę można uzyskać na podstawie CViewklasy , , CScrollViewCFormViewlub CEditView. (Możesz również użyć CEditView bezpośrednio).

• Klasa okna ramowego, która zawiera widok. W przypadku pojedynczej aplikacji interfejsu dokumentu (SDI) należy utworzyć tę klasę z klasy CFrameWnd. W przypadku aplikacji interfejsu wielu dokumentów (MDI) ta klasa pochodzi z CMDIChildWndklasy . Jeśli nie musisz dostosowywać zachowania okna ramki, możesz użyć CFrameWnd lub CMDIChildWnd bezpośrednio bez wyprowadzania własnej klasy.

Aplikacja ma jeden szablon dokumentu dla każdego typu dokumentu, który obsługuje. Jeśli na przykład aplikacja obsługuje arkusze kalkulacyjne i dokumenty tekstowe, aplikacja ma dwa obiekty szablonu dokumentu. Każdy szablon dokumentu jest odpowiedzialny za tworzenie wszystkich dokumentów tego typu i zarządzanie nimi.

Szablon dokumentu przechowuje wskaźniki CRuntimeClass do obiektów dla klas dokumentów, widoków i okien ramowych. Te CRuntimeClass obiekty są określane podczas konstruowania szablonu dokumentu.

Szablon dokumentu zawiera identyfikator zasobów używanych z typem dokumentu (na przykład menu, ikona lub zasoby tabeli akceleratora). Szablon dokumentu zawiera również ciągi zawierające dodatkowe informacje o typie dokumentu. Obejmują one nazwę typu dokumentu (na przykład "Arkusz") i rozszerzenie pliku (na przykład ".xls"). Opcjonalnie może zawierać inne ciągi używane przez interfejs użytkownika aplikacji, Menedżera plików systemu Windows oraz obsługę łączenia obiektów i osadzania (OLE).

Jeśli aplikacja jest kontenerem OLE i/lub serwerem, szablon dokumentu definiuje również identyfikator menu używanego podczas aktywacji w miejscu. Jeśli aplikacja jest serwerem OLE, szablon dokumentu definiuje identyfikator paska narzędzi i menu używane podczas aktywacji w miejscu. Te dodatkowe zasoby OLE należy określić przez wywołanie SetContainerInfo metody i SetServerInfo.

Ponieważ CDocTemplate jest klasą abstrakcyjną, nie można używać jej bezpośrednio. Typowa aplikacja używa jednej z dwóch CDocTemplateklas pochodnych udostępnianych przez bibliotekę klas programu Microsoft Foundation: CSingleDocTemplate, która implementuje elementy SDI i CMultiDocTemplate, które implementują interfejs MDI. Zobacz te klasy, aby uzyskać więcej informacji na temat korzystania z szablonów dokumentów.

Jeśli aplikacja wymaga paradygmatu interfejsu użytkownika, który zasadniczo różni się od standardu SDI lub MDI, możesz utworzyć własną klasę z klasy CDocTemplate.

Aby uzyskać więcej informacji na temat CDocTemplateprogramu , zobacz Szablony dokumentów i Proces tworzenia dokumentu/widoku.

Hierarchia dziedziczenia

CObject

CCmdTarget

CDocTemplate

Wymagania

Nagłówek: afxwin.h

CDocTemplate::AddDocument

Ta funkcja służy do dodawania dokumentu do szablonu.

virtual void AddDocument(CDocument* pDoc);

Parametry

pDoc
Wskaźnik do dodania dokumentu.

Uwagi

Klasy pochodne CMultiDocTemplate i CSingleDocTemplate przesłaniają tę funkcję. Jeśli utworzysz własną klasę szablonu dokumentu z CDocTemplateklasy , klasa pochodna musi zastąpić tę funkcję.

CDocTemplate::CDocTemplate

CDocTemplate Tworzy obiekt.

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

Parametry

nIDResource
Określa identyfikator zasobów używanych z typem dokumentu. Może to obejmować menu, ikonę, tabelę akceleratora i zasoby ciągów.

Zasób ciągu składa się z maksymalnie siedmiu podciągów oddzielonych znakiem (\nznak jest wymagany jako posiadacz zastępczy, jeśli podciąg nie jest uwzględniony\n; jednak \n końcowe znaki nie są konieczne); te podciągy opisują typ dokumentu. Aby uzyskać informacje na temat podciągów, zobacz GetDocString. Ten zasób ciągu znajduje się w pliku zasobów aplikacji. Na przykład:

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

Zwróć uwagę, że ciąg zaczyna się od znaku; jest to spowodowane tym, że pierwsze podciągi \n nie są używane dla aplikacji MDI i tak nie są uwzględniane. Ten ciąg można edytować przy użyciu edytora ciągów. cały ciąg jest wyświetlany jako pojedynczy wpis w Edytorze ciągów, a nie jako siedem oddzielnych wpisów.

pDocClass
CRuntimeClass Wskazuje obiekt klasy dokumentu. Ta klasa jest klasą pochodną zdefiniowaną CDocumentdo reprezentowania dokumentów.

pFrameClass
CRuntimeClass Wskazuje obiekt klasy okna ramowego. Ta klasa może być klasą pochodną CFrameWndlub może być CFrameWnd sama w przypadku zachowania domyślnego dla głównego okna ramowego.

pViewClass
CRuntimeClass Wskazuje obiekt klasy widoków. Ta klasa jest klasą pochodną zdefiniowaną CViewdo wyświetlania dokumentów.

Uwagi

Użyj tej funkcji składowej CDocTemplate , aby skonstruować obiekt. Dynamicznie przydzielaj CDocTemplate obiekt i przekazuje go do CWinApp::AddDocTemplate funkcji InitInstance składowej klasy aplikacji.

CDocTemplate::CloseAllDocuments

Wywołaj tę funkcję składową, aby zamknąć wszystkie otwarte dokumenty.

virtual void CloseAllDocuments(BOOL bEndSession);

Parametry

bEndSession
Nie używany.

Uwagi

Ta funkcja składowa jest zwykle używana jako część polecenia Zakończ plik. Domyślna implementacja tej funkcji wywołuje CDocument::DeleteContents funkcję składową, aby usunąć dane dokumentu, a następnie zamyka okna ramki dla wszystkich widoków dołączonych do dokumentu.

Zastąpi tę funkcję, jeśli chcesz, aby użytkownik wykonał specjalne przetwarzanie oczyszczania przed zamknięciem dokumentu. Jeśli na przykład dokument reprezentuje rekord w bazie danych, możesz zastąpić tę funkcję, aby zamknąć bazę danych.

CDocTemplate::CreateNewDocument

Wywołaj tę funkcję składową, aby utworzyć nowy dokument typu skojarzonego z tym szablonem dokumentu.

virtual CDocument* CreateNewDocument();

Wartość zwracana

Wskaźnik do nowo utworzonego dokumentu lub NULL jeśli wystąpi błąd.

CDocTemplate::CreateNewFrame

Tworzy nowe okno ramki zawierające dokument i widok.

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

Parametry

pDoc
Dokument, do którego powinno się odwoływać nowe okno ramki. Może to być NULL.

pOther
Okno ramowe, na którym ma być oparte nowe okno ramki. Może to być NULL.

Wartość zwracana

Wskaźnik do nowo utworzonego okna ramki lub NULL jeśli wystąpi błąd.

Uwagi

CreateNewFrameCRuntimeClass używa obiektów przekazanych do konstruktora, aby utworzyć nowe okno ramki z dołączonym widokiem i dokumentem. pDoc Jeśli parametr ma NULLwartość , struktura generuje TRACE komunikat.

Parametr pOther służy do implementowania polecenia Window New. Zapewnia okno ramowe, na którym można modelować nowe okno ramki. Nowe okno ramki jest zwykle tworzone niewidoczne. Wywołaj tę funkcję, aby utworzyć okna ramowe poza standardową implementacją struktury Plik nowy i Otwórz plik.

CDocTemplate::CreateOleFrame

Tworzy okno ramki OLE.

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

Parametry

pParentWnd
Wskaźnik do okna nadrzędnego ramki.

pDoc
Wskaźnik do dokumentu, do którego powinno odwoływać się nowe okno ramki OLE.

bCreateView
Określa, czy widok jest tworzony wraz z ramką.

Wartość zwracana

Wskaźnik do okna ramki, jeśli się powiedzie; w przeciwnym razie NULL.

Uwagi

Jeśli bCreateView ma wartość zero, zostanie utworzona pusta ramka.

CDocTemplate::GetDocString

Pobiera ciąg skojarzony z typem dokumentu.

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

Parametry

rString
Odwołanie do CString obiektu, który będzie zawierać ciąg po powrocie funkcji.

index
Indeks podciągów pobieranych z ciągu opisującego typ dokumentu. Ten parametr może mieć jedną z następujących wartości:

• CDocTemplate::windowTitle Nazwa wyświetlana na pasku tytułu okna aplikacji (na przykład "Microsoft Excel"). Obecny tylko w szablonie dokumentu dla aplikacji SDI.

• CDocTemplate::docName Katalog główny domyślnej nazwy dokumentu (na przykład "Arkusz"). Ten katalog główny, plus liczba, jest używany jako domyślna nazwa nowego dokumentu tego typu za każdym razem, gdy użytkownik wybierze polecenie Nowy z menu Plik (na przykład "Arkusz1" lub "Arkusz2"). Jeśli nie zostanie określony, opcja "Bez tytułu" jest używana jako wartość domyślna.

• CDocTemplate::fileNewName Nazwa tego typu dokumentu. Jeśli aplikacja obsługuje więcej niż jeden typ dokumentu, ten ciąg jest wyświetlany w oknie dialogowym Nowy plik (na przykład "Arkusz"). Jeśli nie zostanie określony, typ dokumentu jest niedostępny przy użyciu polecenia Plik nowy .

• CDocTemplate::filterName Opis typu dokumentu i wieloznaczny filtr pasujący do dokumentów tego typu. Ten ciąg jest wyświetlany na liście rozwijanej Pliki typu listy w oknie dialogowym Otwieranie pliku (na przykład "Arkusze (*.xls)"). Jeśli nie zostanie określony, typ dokumentu jest niedostępny przy użyciu polecenia Otwórz plik.

• CDocTemplate::filterExt Rozszerzenie dla dokumentów tego typu (na przykład ".xls"). Jeśli nie zostanie określony, typ dokumentu jest niedostępny przy użyciu polecenia Otwórz plik.

• CDocTemplate::regFileTypeId Identyfikator typu dokumentu, który ma być przechowywany w bazie danych rejestracji obsługiwanej przez system Windows. Ten ciąg jest przeznaczony tylko do użytku wewnętrznego (na przykład "ExcelWorksheet"). Jeśli nie zostanie określony, nie można zarejestrować typu dokumentu w Menedżerze plików systemu Windows.

• CDocTemplate::regFileTypeName Nazwa typu dokumentu, który ma być przechowywany w bazie danych rejestracji. Ten ciąg może być wyświetlany w oknach dialogowych aplikacji, które uzyskują dostęp do bazy danych rejestracji (na przykład "Arkusz programu Microsoft Excel").

Wartość zwracana

Nonzero, jeśli znaleziono określony podciąg; w przeciwnym razie 0.

Uwagi

Wywołaj tę funkcję, aby pobrać określony podciąg opisujący typ dokumentu. Ciąg zawierający te podciągy jest przechowywany w szablonie dokumentu i pochodzi z ciągu w pliku zasobów aplikacji. Struktura wywołuje tę funkcję, aby uzyskać ciągi potrzebne dla interfejsu użytkownika aplikacji. Jeśli określono rozszerzenie nazwy pliku dla dokumentów aplikacji, struktura wywołuje również tę funkcję podczas dodawania wpisu do bazy danych rejestracji systemu Windows; Umożliwia to otwieranie dokumentów z Menedżera plików systemu Windows.

Wywołaj tę funkcję tylko wtedy, gdy wyprowadzasz własną klasę z klasy CDocTemplate.

CDocTemplate::GetFirstDocPosition

Pobiera pozycję pierwszego dokumentu skojarzonego z tym szablonem.

virtual POSITION GetFirstDocPosition() const = 0;

Wartość zwracana

POSITION Wartość, która może służyć do iterowania po liście dokumentów skojarzonych z tym szablonem dokumentu lub NULL jeśli lista jest pusta.

Uwagi

Użyj tej funkcji, aby uzyskać pozycję pierwszego dokumentu na liście dokumentów skojarzonych z tym szablonem. Użyj wartości jako argumentu POSITION , aby CDocTemplate::GetNextDoc iterować listę dokumentów skojarzonych z szablonem.

CSingleDocTemplate i CMultiDocTemplate oba zastąpić tę czystą funkcję wirtualną. Każda klasa, z CDocTemplate której pochodzisz, musi również zastąpić tę funkcję.

CDocTemplate::GetNextDoc

Pobiera element listy zidentyfikowany przez rPoselement , a następnie ustawia rPos wartość POSITION następnego wpisu na liście.

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

Wartość zwracana

Wskaźnik do następnego dokumentu na liście dokumentów skojarzonych z tym szablonem.

Parametry

rPos
Odwołanie do POSITION wartości zwróconej przez poprzednie wywołanie metody GetFirstDocPosition lub GetNextDoc.

Uwagi

Jeśli pobrany element jest ostatnim elementem na liście, nowa wartość parametru jest ustawiona rPos na NULLwartość .

Można użyć GetNextDoc w pętli iteracji przesyłania dalej, jeśli ustanowisz pozycję początkową z wywołaniem metody GetFirstDocPosition.

Musisz upewnić się, że wartość POSITION reprezentuje prawidłową pozycję na liście. Jeśli jest on nieprawidłowy, oznacza to, że wersja debugowania biblioteki klas programu Microsoft Foundation jest asercyjna.

CDocTemplate::InitialUpdateFrame

Inicjuje okno ramki i opcjonalnie sprawia, że jest widoczny.

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

Parametry

pFrame
Okno ramki, które wymaga wstępnej aktualizacji.

pDoc
Dokument, z którym jest skojarzona ramka. Może to być NULL.

bMakeVisible
Wskazuje, czy ramka powinna stać się widoczna i aktywna.

Uwagi

Wywołaj metodę IntitialUpdateFrame po utworzeniu nowej ramki za pomocą polecenia CreateNewFrame. Wywołanie tej funkcji powoduje, że widoki w tym oknie ramowym odbierają wywołania OnInitialUpdate . Ponadto, jeśli nie było wcześniej aktywnego widoku, podstawowy widok okna ramki jest aktywny; widok podstawowy jest widokiem o identyfikatorze podrzędnym AFX_IDW_PANE_FIRST. Na koniec okno ramki jest widoczne, jeśli bMakeVisible nie ma wartości zero. Jeśli bMakeVisible ma wartość zero, bieżący fokus i widoczny stan okna ramki pozostaną niezmienione.

Nie jest konieczne wywołanie tej funkcji podczas korzystania z implementacji struktury File New i File Open.

CDocTemplate::LoadTemplate

Ładuje zasoby dla danej CDocTemplate klasy lub pochodnej.

virtual void LoadTemplate();

Uwagi

Ta funkcja składowa jest wywoływana przez platformę w celu załadowania zasobów dla danej CDocTemplate klasy lub pochodnej. Zwykle jest wywoływana podczas budowy, z wyjątkiem sytuacji, gdy szablon jest tworzony globalnie. W takim przypadku wywołanie metody jest LoadTemplate opóźnione do momentu CWinApp::AddDocTemplate wywołania.

CDocTemplate::MatchDocType

Określa stopień pewności dopasowania między typem dokumentu a tym szablonem.

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

Parametry

lpszPathName
Nazwa ścieżki pliku, którego typ ma zostać określony.

rpDocMatch
Wskaźnik do dokumentu, który jest przypisany do pasującego dokumentu, jeśli plik określony przez lpszPathName jest już otwarty.

Wartość zwracana

Wartość z Confidence wyliczenia, która jest zdefiniowana w następujący sposób:

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

Uwagi

Użyj tej funkcji, aby określić typ szablonu dokumentu, który ma być używany do otwierania pliku. Jeśli aplikacja obsługuje wiele typów plików, możesz na przykład użyć tej funkcji, aby określić, które z dostępnych szablonów dokumentów są odpowiednie dla danego pliku, wywołując MatchDocType każdy szablon z kolei, i wybierając szablon zgodnie z zwróconą wartością ufności.

Jeśli plik określony przez lpszPathName jest już otwarty, ta funkcja zwraca CDocTemplate::yesAlreadyOpen i kopiuje obiekt pliku CDocument do obiektu pod adresem rpDocMatch.

Jeśli plik nie jest otwarty, ale rozszerzenie w lpszPathName pliku jest zgodne z rozszerzeniem określonym przez CDocTemplate::filterExt, ta funkcja zwraca CDocTemplate::yesAttemptNative i ustawia wartość NULLrpDocMatch . Aby uzyskać więcej informacji na temat CDocTemplate::filterExtprogramu , zobacz CDocTemplate::GetDocString.

Jeśli żaden przypadek nie ma wartości true, funkcja zwraca CDocTemplate::yesAttemptForeignwartość .

Domyślna implementacja nie zwraca CDocTemplate::maybeAttemptForeign wartości ani CDocTemplate::maybeAttemptNative. Zastąpij tę funkcję, aby zaimplementować logikę dopasowywania typów odpowiednią dla aplikacji, na przykład przy użyciu tych dwóch wartości z Confidence wyliczenia.

CDocTemplate::OpenDocumentFile

Otwiera plik określony przez ścieżkę.

virtual CDocument* OpenDocumentFile(LPCTSTR lpszPathName) = 0;

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

Parametry

lpszPathName
[in] Wskaźnik do ścieżki pliku zawierającego dokument do otwarcia.

bAddToMRU
[in] TRUE wskazuje, że dokument jest jednym z najnowszych plików; FALSE wskazuje, że dokument nie jest jednym z najnowszych plików.

Wartość zwracana

Wskaźnik do dokumentu, którego plik ma nazwę lpszPathName; NULL jeśli nie powiedzie się.

Uwagi

Otwiera plik, którego ścieżka jest określona przez lpszPathName. Jeśli lpszPathName jest NULLto , zostanie utworzony nowy plik zawierający dokument typu skojarzonego z tym szablonem.

CDocTemplate::RemoveDocument

Usuwa dokument wskazywany przez pDoc z listy dokumentów skojarzonych z tym szablonem.

virtual void RemoveDocument(CDocument* pDoc);

Parametry

pDoc
Wskaźnik do usunięcia dokumentu.

Uwagi

Klasy pochodne CMultiDocTemplate i CSingleDocTemplate przesłaniają tę funkcję. Jeśli utworzysz własną klasę szablonu dokumentu z CDocTemplateklasy , klasa pochodna musi zastąpić tę funkcję.

CDocTemplate::SaveAllModified

Zapisuje wszystkie zmodyfikowane dokumenty.

virtual BOOL SaveAllModified();

Wartość zwracana

Wartość niezerowa w przypadku powodzenia; w przeciwnym razie 0.

CDocTemplate::SetContainerInfo

Określa zasoby dla kontenerów OLE podczas edytowania elementu OLE w miejscu.

void SetContainerInfo(UINT nIDOleInPlaceContainer);

Parametry

nIDOleInPlaceContainer
Identyfikator zasobów używanych podczas aktywowania obiektu osadzonego.

Uwagi

Wywołaj tę funkcję, aby ustawić zasoby, które mają być używane, gdy obiekt OLE jest aktywowany w miejscu. Te zasoby mogą obejmować menu i tabele akceleratorów. Ta funkcja jest zwykle wywoływana CWinApp::InitInstance w funkcji aplikacji.

Menu skojarzone z nIDOleInPlaceContainer zawiera separatory, które umożliwiają menu aktywowanego elementu w miejscu do scalenia z menu aplikacji kontenera. Aby uzyskać więcej informacji na temat scalania menu serwera i kontenera, zobacz artykuł Menu i zasoby (OLE).

CDocTemplate::SetDefaultTitle

Wywołaj tę funkcję, aby załadować domyślny tytuł dokumentu i wyświetlić go na pasku tytułu dokumentu.

virtual void SetDefaultTitle(CDocument* pDocument) = 0;

Parametry

pDocument
Wskaźnik do dokumentu, którego tytuł ma zostać ustawiony.

Uwagi

Aby uzyskać informacje na temat tytułu domyślnego, zobacz opis w CDocTemplate::docName CDocTemplate::GetDocStringpliku .

CDocTemplate::SetServerInfo

Określa zasoby i klasy, gdy dokument serwera jest osadzony lub edytowany w miejscu.

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

Parametry

nIDOleEmbedding
Identyfikator zasobów używanych podczas otwierania obiektu osadzonego w osobnym oknie.

nIDOleInPlaceServer
Identyfikator zasobów używanych podczas aktywowania obiektu osadzonego w miejscu.

pOleFrameClass
Wskaźnik do struktury zawierającej CRuntimeClass informacje o klasie dla obiektu okna ramowego utworzonego podczas aktywacji w miejscu.

pOleViewClass
Wskaźnik do struktury zawierającej CRuntimeClass informacje o klasie dla obiektu widoku utworzonego podczas aktywacji w miejscu.

Uwagi

Wywołaj tę funkcję składową, aby zidentyfikować zasoby, które będą używane przez aplikację serwera, gdy użytkownik żąda aktywacji obiektu osadzonego. Te zasoby składają się z menu i tabel akceleratorów. Ta funkcja jest zwykle wywoływana w InitInstance aplikacji.

Menu skojarzone z nIDOleInPlaceServer zawiera separatory, które umożliwiają scalanie menu serwera z menu kontenera. Aby uzyskać więcej informacji na temat scalania menu serwera i kontenera, zobacz artykuł Menu i zasoby (OLE).

CDocTemplate::CreatePreviewFrame

Tworzy ramkę podrzędną używaną w wersji zapoznawczej Rich Preview.

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

Parametry

pParentWnd
Wskaźnik do okna nadrzędnego (zwykle dostarczony przez powłokę).

pDoc
Wskaźnik do obiektu dokumentu, którego zawartość będzie podglądowana.

Wartość zwracana

Prawidłowy wskaźnik do CFrameWnd obiektu lub wartość NULL, jeśli tworzenie zakończy się niepowodzeniem.

Uwagi

CDocTemplate::SetPreviewInfo

Konfiguruje program obsługi w wersji zapoznawczej procesu.

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

Parametry

nIDPreviewFrame
Określa identyfikator zasobu ramki podglądu.

pPreviewFrameClass
Określa wskaźnik do struktury informacji o klasie środowiska uruchomieniowego ramki podglądu.

pPreviewViewClass
Określa wskaźnik do struktury informacji o klasie środowiska uruchomieniowego widoku podglądu.

Uwagi

Zobacz też

CCmdTarget Klasa
Wykres hierarchii
CSingleDocTemplate Klasa
CMultiDocTemplate Klasa
CDocument Klasa
CView Klasa
CScrollView Klasa
CEditView Klasa
CFormView Klasa
CFrameWnd Klasa
CMDIChildWnd Klasa