Model obiektu Word — Omówienie

Artykuł
06/10/2015

Podczas opracowywania rozwiązań programu Word w programie Visual Studio kontaktujesz się z modelu obiektów programu Word.Model ten obiekt składa się z klas i interfejsów, które są podane w podstawowego zestawu międzyoperacyjnego dla programu Word i są zdefiniowane w Microsoft.Office.Interop.Word obszaru nazw.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu i aplikacji obsługiwanych w programach Word 2013 i Word 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.

Ten temat zawiera krótkie omówienie modelu obiektów programu Word.Gdzie można uzyskać więcej informacji na temat całego modelu obiektów programu Word zasobów, zobacz za pomocą dokumentacji modelu obiektów programu Word.

Aby uzyskać informacje dotyczące korzystania z modelu obiektów programu Word do wykonywania określonych zadań zobacz następujące tematy:

Opis modelu obiektów programu Word

Program Word oferuje setek obiektów, z których można interakcyjnie pracować.Obiekty te są zorganizowane w hierarchii, znajdujący się blisko interfejsu użytkownika.U góry hierarchii jest Application obiektu.Ten obiekt reprezentuje bieżące wystąpienie programu Word.The Application object contains the Document, Selection, Bookmark, and Range objects.Każdy z tych obiektów ma wiele metod i właściwości, które można uzyskać dostęp do manipulowania i interakcji z obiektem.

Następująca ilustracja pokazuje jeden widok tych obiektów w hierarchii modelu obiektów programu Word.

Streszczenie modelu obiektów programu Word

Model obiektów programu Word grafiki

Na pierwszy rzut oka obiekty pojawiają się na siebie zachodzić.Na przykład Document i Selection obiekty są zarówno członków Application obiektu, ale Document obiektu jest także członkiem Selection obiektu.Obie Document i Selection obiekty zawierają Bookmark i Range obiektów.Nakładanie się występuje, ponieważ istnieje wiele sposobów, można uzyskać dostęp do tego samego rodzaju obiektu.Na przykład zastosować formatowanie do Range obiektu; ale może być dostępu do zakresu z bieżącego zaznaczenia, określonego akapitu, sekcji lub całego dokumentu.

W poniższych sekcjach opisano pokrótce obiektów najwyższego poziomu i jak współdziałają ze sobą.Obiekty te obejmują pięć następujących:

Obiekt aplikacji
Obiekt dokumentu
Zaznaczenie obiektu
Zakres obiektu
Obiekt zakładki

Oprócz modelu obiektów programu Word zapewniają projektów pakietu Office w programie Visual Studio elementy host i hosta formanty , rozszerzenie niektórych obiektów w modelu obiektów programu Word.Host elementów i kontrolek hosta zachowują się jak obiekty programu Word, które rozszerzają one, ale mają także dodatkowe funkcje, takie jak zdolności wiązania z danymi i dodatkowe zdarzenia.Aby uzyskać więcej informacji, zobacz Automatyzowanie programu Word za pomocą obiektów rozszerzonych i Przegląd obiektów hosta i formantów hosta.

Obiekt aplikacji

Application Obiekt reprezentuje aplikację programu Word i jest elementem nadrzędnym wszystkich innych obiektów.Jego członkowie zwykle stosuje się do programu Word jako całości.Można użyć jego właściwości i metody kontroli środowiska programu Word.

W poziomie aplikacji Dodaj w projektach, można uzyskać dostęp Application obiektu za pomocą Application pola ThisAddIn klasy.Aby uzyskać więcej informacji, zobacz Programowanie dodatków na poziomie aplikacji.

W projektach na poziomie dokumentu, można uzyskać dostęp Application obiektu za pomocą Application właściwość ThisDocument klasy.

Obiekt dokumentu

Document Obiekt jest centralnym do programowania w programie Word.Reprezentuje dokument i całą jego zawartość.Podczas otwierania dokumentu lub utworzyć nowy dokument, Utwórz nowy Document obiekt, który jest dodawany do Documents kolekcji Application obiektu.Aktywny dokument nosi nazwę dokumentu, który ma fokus.Jest ona reprezentowana przez ActiveDocument właściwość Application obiektu.

Rozszerzanie narzędzi programistycznych pakietu Office w programie Visual Studio Document obiekt poprzez zapewnienie Document typu.Ten typ jest hosta elementu który daje dostęp do wszystkich funkcji Document obiektu i dodaje dodatkowe zdarzenia oraz możliwość dodawania formantów zarządzanych.

Podczas tworzenia projektu na poziomie dokumentu, można uzyskać dostęp Document członków za pomocą wygenerowanej ThisDocument klasy w projekcie.Można uzyskać dostęp do członków Document element hosta za pomocą Me lub this słowa kluczowe z kodu w ThisDocument klasy lub przy użyciu Globals.ThisDocument z kodu poza ThisDocument klasy.Aby uzyskać więcej informacji, zobacz Programowanie dostosowań na poziome dokumentu.Na przykład zaznacz pierwszy akapit w dokumencie, należy użyć następującego kodu.

Me.Paragraphs(1).Range.Select()

this.Paragraphs[1].Range.Select();

W projektach na poziomie aplikacji, można wygenerować Document hosta elementów w czasie wykonywania.Aby dodać formanty do skojarzonego dokumentu, można użyć elementu generowanych hosta.Aby uzyskać więcej informacji, zobacz Rozszerzanie dokumentów programu Word i skoroszytów w programie Excel w czasie wykonywania w dodatkach na poziomie aplikacji.

Zaznaczenie obiektu

Selection Obiekt reprezentuje obszar, który jest aktualnie zaznaczona.Podczas wykonywania operacji w interfejsie użytkownika programu Word, takich jak pogrubienie tekstu, zaznacz, lub podświetl tekst, a następnie Zastosuj formatowanie.Selection Obiekt zawsze znajduje się w dokumencie.Jeśli nic nie jest zaznaczone, następnie reprezentuje punkt wstawiania.Ponadto zaznaczenie może obejmować wiele bloków tekstu, które nie są ciągłe.

Zakres obiektu

Range Obiekt reprezentuje ciągły obszar w dokumencie i jest definiowana przez pozycji znak początkowej i końcowej pozycji znaku.Nie są ograniczone do pojedynczego Range obiektu.Można zdefiniować wiele Range obiekty w tym samym dokumencie.A Range obiekt ma następujące cechy:

Może się składać wyłącznie punkt wstawiania, zakres tekstu lub całego dokumentu.
Obejmuje on znaki niedrukowalne, takie jak spacje, znaki tabulacji i znaki akapitu.
Obszar, reprezentowane przez bieżące zaznaczenie może być lub może reprezentować obszar różnych od bieżącego zaznaczenia.
Nie jest widoczne w dokumencie, w przeciwieństwie do zaznaczenia, która jest zawsze widoczna.
To nie jest zapisywany z dokumentu i istnieje tylko w przypadku, gdy kod jest uruchomiony.

Podczas wstawiania tekstu na końcu zakresu, program Word automatycznie rozszerza zakres, aby dołączyć wstawionego tekstu.

Obiekty kontroli zawartości

A ContentControl umożliwia kontrolowanie danych wejściowych i prezentacji tekstu i innych typów zawartości w dokumentach programu Word.A ContentControl można wyświetlić kilka różnych typów interfejsu użytkownika, które są zoptymalizowane pod kątem użycia w dokumentach programu Word, takie jak formant tekstu sformatowanego, wyboru daty lub pola kombi.Można również użyć ContentControl , aby uniemożliwić użytkownikom edytowanie sekcje dokumentu lub szablonu.

Rozszerza Visual Studio ContentControl obiektu do kilku formantów innego hosta.Należy ContentControl obiektu można wyświetlić dowolnego z różnych typów interfejsu użytkownika, które są dostępne dla formantów zawartości, programu Visual Studio zawiera inny typ dla każdego formantu zawartości.Na przykład, można użyć RichTextContentControl można użyć do utworzenia formantu tekstu sformatowanego, lub DatePickerContentControl , aby utworzyć formant wyboru daty.Te formanty hosta zachowują się jak w trybie macierzystym ContentControl, ale mają dodatkowe zdarzenia i zdolności wiązania z danymi.Aby uzyskać więcej informacji, zobacz Formanty zawartości.

Obiekt zakładki

Bookmark Obiekt reprezentuje ciągły obszar w dokumencie, zarówno z pozycji początkowej i końcowej pozycji.Zakładek można użyć do oznaczenia lokalizacji w dokumencie lub jako kontener dla tekstu w dokumencie.A Bookmark obiektu można składać się z punktem wstawiania lub być tak duży jak cały dokument.A Bookmark ma następujące cechy, które odróżniają go od Range obiekt:

W czasie projektowania, można nadać nazwę zakładki.
Bookmarkobiekty są zapisywane wraz z dokumentem i zatem nie są usuwane w gdy kod przestanie działać lub dokumencie jest zamknięty.
Zakładki mogą być ukryte lub widoczne przez ustawienie ShowBookmarks właściwość View obiektu do false lub true.

Rozszerza Visual Studio Bookmark obiekt poprzez zapewnienie Bookmark hosta kontroli.Bookmark Sterowanie hostem zachowuje się jak w trybie macierzystym Bookmark, ale ma dodatkowe zdarzenia i zdolności wiązania z danymi.Dane można powiązać formant zakładek w dokumencie w taki sam sposób powiązania danych do formantu pola tekstowego w formularzu Windows.Aby uzyskać więcej informacji, zobacz Formant zakładki.

Korzystając z dokumentacji modelu obiektów programu Word

Pełne informacje dotyczące modelu obiektów programu Word może odnosić się do odwołania podstawowego zestawu międzyoperacyjnego (PIA) programu Word i Visual Basic for Applications (VBA) odwołanie do modelu obiektu.

Odwołania podstawowego zestawu międzyoperacyjnego

Dokumentacji referencyjnej PIA programu Word zawiera opis typów podstawowego zestawu międzyoperacyjnego dla programu Word.Dokumentacja ta jest dostępna z następującej lokalizacji: Odwołanie do programu Word 2010 podstawowego zestawu Interop.

Aby uzyskać więcej informacji na temat projektowania PIA programu Word, takie jak różnice między klas i interfejsów PIA i sposobu implementacji zdarzenia w PIA zobacz Omówienie klas i interfejsów w podstawowe zestawy Interop Office.

Odwołanie do modelu obiektu języka VBA

Odwołanie do modelu obiektu języka VBA dokumentów modelu obiektów programu Word jako kod VBA jest narażony.Aby uzyskać więcej informacji, zobacz Informacje o modelu obiektów programu Word 2010.

Wszystkie obiekty i elementy członkowskie w odwołanie do modelu obiektu języka VBA odpowiadają typów i członków w PIA programu Word.Na przykład Document obiekt w odwołanie do modelu obiektu języka VBA odpowiada Document obiektu w PIA programu Word.Mimo, że odwołanie do modelu obiektu języka VBA zawiera przykłady kodu dla większości właściwości, metod i zdarzeń, należy przetłumaczyć kodu VBA w tym odniesienia do programu Visual Basic lub Visual C#, jeśli chcesz ich użyć w wyrazie projektu utworzonych przy użyciu programu Visual Studio.