Omówienie modelu obiektów programu Word

  • Artykuł

Podczas opracowywania rozwiązań programu Word w programie Visual Studio interakcja z modelem obiektów programu Word. Ten model obiektów składa się z klas i interfejsów, które są udostępniane w podstawowym zestawie międzyoperacyjności dla programu Word i są zdefiniowane w Microsoft.Office.Interop.Word przestrzeni nazw.

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu i projektów dodatków VSTO dla programu Word. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

Ten temat zawiera krótkie omówienie modelu obiektów programu Word. Aby uzyskać więcej informacji na temat całego modelu obiektów programu Word, zobacz Korzystanie z dokumentacji modelu obiektów programu Word.

Aby uzyskać informacje na temat używania modelu obiektów programu Word do wykonywania określonych zadań, zobacz następujące tematy:

Omówienie modelu obiektów programu Word

Program Word udostępnia setki obiektów, z którymi można korzystać. Te obiekty są zorganizowane w hierarchii ściśle zgodnej z interfejsem użytkownika. W górnej części hierarchii znajduje się Application obiekt . Ten obiekt reprezentuje bieżące wystąpienie programu Word. Obiekt Application zawiera Documentobiekty , Selection, Bookmarki Range . Każdy z tych obiektów ma wiele metod i właściwości, do których można uzyskać dostęp do manipulowania obiektem i interakcji z nim.

Poniższa ilustracja przedstawia jeden widok tych obiektów w hierarchii modelu obiektów programu Word.

Word Object Model graphic

Na pierwszy rzut oka obiekty wydają się nakładać się na siebie. Na przykład Document obiekty i Selection są elementami członkowskimi Application obiektu, ale Document obiekt jest również elementem członkowskim Selection obiektu. Document Obiekty i Selection zawierają Bookmark obiekty i i Range . Nakładanie się istnieje, ponieważ istnieje wiele sposobów uzyskiwania dostępu do tego samego typu obiektu. Na przykład stosujesz formatowanie do obiektu, ale możesz chcieć uzyskać dostęp do Range zakresu bieżącego zaznaczenia, określonego akapitu, sekcji lub całego dokumentu.

W poniższych sekcjach krótko opisano obiekty najwyższego poziomu i sposób interakcji ze sobą. Te obiekty obejmują następujące pięć:

  • Obiekt aplikacji

  • Obiekt dokumentu

  • Obiekt zaznaczenia

  • obiekt zakresu

  • Obiekt zakładki

    Oprócz modelu obiektów programu Word projekty pakietu Office w programie Visual Studio udostępniają elementy hosta i kontrolki hosta, które rozszerzają niektóre obiekty w modelu obiektów programu Word. Elementy hosta i kontrolki hosta zachowują się jak rozszerzane obiekty programu Word, ale mają również dodatkowe funkcje, takie jak możliwości powiązania danych i dodatkowe zdarzenia. Aby uzyskać więcej informacji, zobacz Automatyzowanie programu Word przy użyciu obiektów rozszerzonych oraz elementów hosta i kontrolek hosta — omówienie.

Obiekt aplikacji

Obiekt Application reprezentuje aplikację programu Word i jest elementem nadrzędnym wszystkich innych obiektów. Jego członkowie zwykle mają zastosowanie do programu Word jako całości. Możesz użyć jej właściwości i metod do kontrolowania środowiska programu Word.

W projektach dodatków VSTO można uzyskać dostęp do Application obiektu przy użyciu Application pola ThisAddIn klasy . Aby uzyskać więcej informacji, zobacz Program VSTO Add-ins (Dodatki programu VSTO).

W projektach na poziomie dokumentu można uzyskać dostęp do Application obiektu przy użyciu Application właściwości ThisDocument klasy .

Obiekt dokumentu

Obiekt Document jest centralnym elementem programowania programu Word. Reprezentuje on dokument i całą jego zawartość. Po otwarciu dokumentu lub utworzeniu nowego dokumentu utworzysz nowy Document obiekt, który zostanie dodany do Documents kolekcji Application obiektu. Dokument, który ma fokus, jest nazywany aktywnym dokumentem. Jest reprezentowana przez ActiveDocument właściwość Application obiektu.

Narzędzia programistyczne pakietu Office w programie Visual Studio rozszerzają Document obiekt, podając Document typ. Ten typ jest elementem hosta, który zapewnia dostęp do wszystkich funkcji Document obiektu i dodaje dodatkowe zdarzenia oraz możliwość dodawania kontrolek zarządzanych.

Podczas tworzenia projektu na poziomie dokumentu można uzyskać dostęp do Document elementów członkowskich przy użyciu wygenerowanej ThisDocument klasy w projekcie. Możesz uzyskać dostęp do elementów członkowskich Document elementu hosta przy użyciu słowa kluczowego Me lub tego słowa kluczowego z kodu w ThisDocument klasie lub przy użyciu Globals.ThisDocument kodu spoza ThisDocument klasy. Aby uzyskać więcej informacji, zobacz Dostosowywanie na poziomie dokumentu programu. Aby na przykład wybrać pierwszy akapit w dokumencie, użyj następującego kodu.

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

W projektach dodatków VSTO można generować Document elementy hosta w czasie wykonywania. Wygenerowany element hosta umożliwia dodawanie kontrolek do skojarzonego dokumentu. Aby uzyskać więcej informacji, zobacz Rozszerzanie dokumentów programu Word i skoroszytów programu Excel w dodatku VSTO w czasie wykonywania.

Obiekt zaznaczenia

Obiekt Selection reprezentuje aktualnie zaznaczony obszar. Podczas wykonywania operacji w interfejsie użytkownika programu Word, takiej jak pogrubienie tekstu, zaznaczasz lub wyróżniasz tekst, a następnie zastosuj formatowanie. Obiekt Selection jest zawsze obecny w dokumencie. Jeśli nic nie jest zaznaczone, reprezentuje punkt wstawiania. Ponadto zaznaczenie może obejmować wiele bloków tekstu, które nie są ciągłe.

obiekt zakresu

Obiekt Range reprezentuje ciągły obszar w dokumencie i jest definiowany przez położenie znaku początkowego i położenie znaku końcowego. Nie ograniczasz się do pojedynczego Range obiektu. W tym samym dokumencie można zdefiniować wiele Range obiektów. Obiekt Range ma następujące cechy:

  • Może składać się z samego punktu wstawiania, zakresu tekstu lub całego dokumentu.

  • Zawiera on znaki niedrukowane, takie jak spacje, znaki tabulatora i znaczniki akapitu.

  • Może to być obszar reprezentowany przez bieżące zaznaczenie lub może reprezentować obszar inny niż bieżące zaznaczenie.

  • Nie jest on widoczny w dokumencie, w przeciwieństwie do zaznaczenia, który jest zawsze widoczny.

  • Nie jest on zapisywany przy użyciu dokumentu i istnieje tylko wtedy, gdy kod jest uruchomiony.

    Po wstawieniu tekstu na końcu zakresu program Word automatycznie rozszerza zakres, aby uwzględnić wstawiony tekst.

Obiekty kontrolki zawartości

Element ContentControl umożliwia kontrolowanie danych wejściowych i prezentacji tekstu oraz innych typów zawartości w dokumentach programu Word. Obiekt ContentControl może wyświetlać kilka różnych typów interfejsu użytkownika zoptymalizowanych pod kątem użycia w dokumentach programu Word, takich jak kontrolka tekstu sformatowanego, selektor daty lub pole kombi. Można również użyć elementu , ContentControl aby uniemożliwić użytkownikom edytowanie sekcji dokumentu lub szablonu.

Program Visual Studio rozszerza obiekt na ContentControl kilka różnych kontrolek hosta. ContentControl Podczas gdy obiekt może wyświetlać dowolny z różnych typów interfejsu użytkownika, które są dostępne dla kontrolek zawartości, program Visual Studio udostępnia inny typ dla każdej kontrolki zawartości. Możesz na przykład użyć elementu , RichTextContentControl aby utworzyć kontrolkę tekstu sformatowanego lub użyć elementu , DatePickerContentControl aby utworzyć selektor dat. Te kontrolki hosta zachowują się jak natywne ContentControl, ale mają dodatkowe zdarzenia i możliwości powiązania danych. Aby uzyskać więcej informacji, zobacz Kontrolki zawartości.

Obiekt zakładki

Obiekt Bookmark reprezentuje ciągły obszar w dokumencie z pozycją początkową i końcową. Za pomocą zakładek można oznaczyć lokalizację w dokumencie lub jako kontener tekstu w dokumencie. Obiekt Bookmark może składać się z punktu wstawiania lub być tak duży, jak cały dokument. Obiekt Bookmark ma następujące cechy, które odróżniają go od Range obiektu:

  • Zakładkę można nazwać w czasie projektowania.

  • Bookmark obiekty są zapisywane w dokumencie i dlatego nie są usuwane po zatrzymaniu działania kodu lub zamknięciu dokumentu.

  • Zakładki mogą być ukryte lub widoczne, ustawiając ShowBookmarks właściwość View obiektu na false lub true.

    Program Visual Studio rozszerza Bookmark obiekt, zapewniając kontrolkę Bookmark hosta. Kontrolka Bookmark hosta działa jak natywna Bookmark, ale ma dodatkowe zdarzenia i możliwości powiązania danych. Dane można powiązać z kontrolką zakładki w dokumencie w taki sam sposób, jak dane są powiązane z kontrolką pola tekstowego w formularzu systemu Windows. Aby uzyskać więcej informacji, zobacz Kontrolka zakładki.

Korzystanie z dokumentacji modelu obiektów programu Word

Aby uzyskać pełne informacje na temat modelu obiektów programu Word, możesz zapoznać się z dokumentacją podstawowego zestawu międzyoperacowego programu Word (PIA) i dokumentacją modelu obiektów języka Visual Basic for Applications (VBA).

Dokumentacja podstawowego zestawu międzyoperajowego

Dokumentacja referencyjna usługi Word PIA opisuje typy w podstawowym zestawie międzyoperajowym dla programu Word. Ta dokumentacja jest dostępna w następującej lokalizacji: podstawowa dokumentacja zestawu międzyoperacowego programu Word 2010.

Aby uzyskać więcej informacji na temat projektowania usługi Word PIA, takich jak różnice między klasami i interfejsami w usłudze PIA oraz sposób implementacji zdarzeń w usłudze PIA, zobacz Omówienie klas i interfejsów w podstawowych zestawach międzyoperacyjnych pakietu Office.

Dokumentacja modelu obiektów VBA

Model obiektów VBA odwołuje się do modelu obiektów programu Word, ponieważ jest on uwidaczniony w kodzie VBA. Aby uzyskać więcej informacji, zobacz Dokumentacja modelu obiektów programu Word 2010.

Wszystkie obiekty i elementy członkowskie w odwołaniu do modelu obiektów VBA odpowiadają typom i członkom w usłudze Word PIA. Na przykład obiekt Document w odwołaniu do modelu obiektów VBA odpowiada Document obiektowi w usłudze Word PIA. Mimo że odwołanie do modelu obiektów VBA zawiera przykłady kodu dla większości właściwości, metod i zdarzeń, należy przetłumaczyć kod VBA w tym odwołaniu do języka Visual Basic lub Visual C#, jeśli chcesz ich używać w projekcie programu Word tworzonym przy użyciu programu Visual Studio.

Powiązana zawartość