Krav: Brug VSTO til at udvikle et simpelt plug-in til Office, såsom at få Word-plugin'et til kinesiske tegnlængder.
Ordobjektmodel
Word tilbyder hundredvis af objekter at interagere med. Disse objekter er organiseret i et hierarki, der nøje følger brugergrænsefladen. Application-objektet ligger øverst i hierarkiet. Dette objekt repræsenterer den aktuelle instans af Word. Applikationsobjektet indeholder objekterne Dokument, Udvælgelse, Bogmærke og Område. Hvert af disse objekter har en række metoder og egenskaber, der kan bruges til at manipulere og interagere med objektet.
Det følgende billede viser et billede af disse objekter i Word-objektmodelhierarkiet.
Dokumentation:Hyperlink-login er synlig.
Applikationsobjekt
Application-objektet repræsenterer Word-applikationen og er forælder til alle andre objekter. Dets medlemmer anvendes som regel på Word som helhed. Du kan bruge dets egenskaber og metoder til at styre Word-miljøet.
I et VSTO-tilføjelsesprojekt kan du få adgang til objektet ThisAddIn ved at bruge Application-felterne i Application-klassen.
I et dokumentprojektniveau kan ThisDocument-objektet tilgås ved at bruge applikationsegenskaben for applikationsklassen.
Dokumentobjekt
Dokument-objektet er centrum for Word-programmering. Det repræsenterer et dokument og alt dets indhold. Når du åbner et dokument eller opretter et nyt dokument, oprettes et nyt Dokumentobjekt og tilføjes til Applikationssamlingen af Dokument-objektet. Et dokument med fokus kaldes et aktivt dokument. Det repræsenteres af Application-egenskaben for ActiveDocument-objektet.
Når du opretter et dokumentniveauprojekt, kan du få adgang til ThisDocument-medlemmet ved at bruge Document-klassen, der genereres i projektet. Objektet ThisDocument kan tilgås ved at bruge Me eller dette nøgleord for kode i Document-klassen, eller ved at bruge Globals.ThisDocument til kode uden for ThisDocument-klassen.
Udvælgelsesobjekt
Selection-objektet repræsenterer det aktuelt valgte område. Når du udfører en handling i Word-brugergrænsefladen, såsom at fremhæve tekst, kan du vælge eller markere teksten og derefter anvende formateringen. Selection-objektet er altid til stede i dokumentet. Hvis intet er markeret, indikerer det et indsættelsespunkt. Derudover kan det valgte indhold indeholde flere ikke-tilstødende tekstblokke.
Afstandsobjekt
Objektet Range repræsenterer tilstødende områder i dokumentet og defineres af start- og slutkarakterernes positioner. Det er ikke begrænset til et enkelt Range-objekt. Du kan definere flere Range-objekter i det samme dokument. Afstandsobjekter har følgende karakteristika:
- Den kan kun indeholde individuelle indsættelsespunkter, eller den kan indeholde et tekstinterval eller hele dokumentet.
- Den inkluderer ikke-trykte tegn som mellemrum, tabulatorer og afsnitsmarkører.
- Det kan være det område, der repræsenteres af det aktuelt valgte indhold, eller det område, der adskiller sig fra dette indhold.
- Det er ikke synligt i dokumentet, i modsætning til det valgte indhold, som altid er synligt.
- Den gemmes ikke sammen med dokumentationen og eksisterer kun, når koden kører.
- Når tekst indsættes i slutningen af et interval, udvider Word automatisk intervallet til at inkludere den indsatte tekst.
Indholdskontrolobjekter (Indholdskontrolobjekter)
ContentControl giver en måde at kontrollere input og gengivelse af tekst og andre typer indhold i et Word-dokument. ContentControl kan vise mange forskellige typer brugerflade, der er optimeret til brug i Word-dokumenter, såsom tekstkontroller med flere beskeder, datovælgere eller kombinationsbokse. Du kan også bruge ContentControl til at forhindre brugere i at redigere visse sektioner af et dokument eller en skabelon.
Visual Studio udvider ContentControl-objektet til flere forskellige værtskontroller. Mens ContentControl-objektet viser alle de forskellige typer brugergrænseflader, der er tilgængelige for indholdskontroller, tilbyder Visual Studio en forskellig type for hver indholdskontrol. For eksempel kan du bruge RichTextContentControl til at oprette en tekstkontrol med flere beskeder, eller du kan bruge DatePickerContentControl til at lave en datovælger. Disse host-kontroller opfører sig på samme måde som native ContentControls, men de har også yderligere event- og databindingsmuligheder.
Bogmærkeobjekt
Bogmærkeobjektet repræsenterer tilstødende områder i et dokument med både start- og slutpositioner. Du kan bruge bogmærker til at markere en placering i dokumentet eller som en beholder til den kinesiske version af dokumentet. Et Bookmark-objekt kan indeholde indsættelsespunkter eller være lige så stort som hele dokumentet. Bogmærket har følgende karakteristika, der adskiller det fra Range-objekter:
- Du kan navngive bogmærker, når du designer.
- Bogmærkeobjektet gemmes sammen med dokumentet, så det slettes ikke, når koden stopper med at køre eller dokumentet lukkes.
- Få adgang til View-egenskaben ved at sætte View-egenskaben til falsk eller sand.
- Visual Studio udvider Bookmark-objektet ved at tilbyde en Bookmark host-kontrol. Bogmærkeværtskontroller opfører sig på samme måde som native Bookmark, men de har også yderligere event- og databindingsfunktioner. Du kan binde data til en bogmærkekontrol på et dokument på samme måde, som du binder data til en tekstboks-kontrol på en Windows-formular.
Opret et Word VSTO-tilføjelsesprogram
Efter at have forstået de grundlæggende koncepter, åbn VS 2022 for at skabe et nyt Word VSTO-tilføjelsesprogram, som vist i figuren nedenfor:
Lav et visuelt bånd som vist i følgende figur:
Dobbeltklik Ribbon1.cs for at åbne, fjern standardfanen, og træk en ny fane ind, som vist nedenfor:
Træk en gruppe- og en knapkontrol ind i den nye fane, som vist nedenfor:
Dobbeltklik på den nyoprettede knap for at oprette en klikbegivenhed med følgende kode:
(Slut)
|
Opslået på 30/04/2023 20.53.15
|
|
|
|
Udlejer|
Opslået på 30/04/2023 23.32.31
|
Opslået på 02/05/2023 10.30.48