Krav: Bruk VSTO for å utvikle en enkel plug-in for Office, for eksempel å skaffe Word-pluginen for kinesisk tegnlengde.
Word-objektmodell
Word tilbyr hundrevis av objekter å samhandle med. Disse objektene er organisert i et hierarki som strengt følger brukergrensesnittet. Applikasjonsobjektet er øverst i hierarkiet. Dette objektet representerer den nåværende instansen av Word. Applikasjonsobjektet inneholder objektene Dokument, Utvalg, Bokmerke og Område. Hvert av disse objektene har en rekke metoder og egenskaper som kan brukes til å manipulere og samhandle med objektet.
Følgende bilde viser en visning av disse objektene i Word-objektmodellhierarkiet.
Dokumentasjon:Innloggingen med hyperkoblingen er synlig.
Applikasjonsobjekt
Application-objektet representerer Word-applikasjonen og er forelderen til alle andre objekter. Medlemmene brukes vanligvis om Word som helhet. Du kan bruke egenskapene og metodene til å kontrollere Word-miljøet.
I et VSTO-tilleggsprosjekt kan du få tilgang til objektet ThisAddIn ved å bruke applikasjonsfeltene i applikasjonsklassen.
I et dokumentnivåprosjekt kan ThisDocument-objektet nås ved å bruke applikasjonsegenskapen til applikasjonsklassen.
Dokumentobjekt
Dokument-objektet er sentrum for Word-programmering. Det representerer et dokument og alt dets innhold. Når du åpner et dokument eller oppretter et nytt dokument, opprettes et nytt Dokumentobjekt og legges til i applikasjonssamlingen av Dokument-objektet. Et dokument med fokus kalles et aktivt dokument. Den representeres av applikasjonsegenskapen til ActiveDocument-objektet.
Når du oppretter et dokumentnivåprosjekt, kan du få tilgang til ThisDocument-medlemmet ved å bruke Document-klassen som genereres i prosjektet. Objektet ThisDocument kan nås ved å bruke Me eller dette nøkkelordet for kode i Document-klassen, eller ved å bruke Globals.ThisDocument for kode utenfor ThisDocument-klassen.
Utvalgsobjekt
Selection-objektet representerer det nåværende valgte området. Når du utfører en handling i Word-brukergrensesnittet, som å fet tekst, kan du velge eller markere teksten og deretter bruke formateringen. Selection-objektet er alltid til stede i dokumentet. Hvis ingenting er sjekket, indikerer det et innsettingspunkt. I tillegg kan det valgte innholdet inneholde flere ikke-tilstøtende tekstblokker.
Avstandsobjekt
Objektet Range representerer tilstøtende områder i dokumentet og defineres av start- og sluttkarakterposisjonene. Det er ikke begrenset til ett enkelt Range-objekt. Du kan definere flere Range-objekter i samme dokument. Avstandsobjekter har følgende egenskaper:
- Den kan kun inneholde individuelle innsettingspunkter, eller den kan inneholde et tekstområde eller hele dokumentet.
- Den inkluderer ikke-trykte tegn som mellomrom, tabulatorer og avsnittsmarkører.
- Det kan være området som representeres av det nåværende valgte innholdet, eller området som er forskjellig fra dette innholdet.
- Det er ikke synlig i dokumentet, i motsetning til det valgte innholdet, som alltid er synlig.
- Den lagres ikke sammen med dokumentasjonen og eksisterer bare når koden kjører.
- Når tekst settes inn på slutten av et område, utvider Word automatisk området til å inkludere den innsatte teksten.
Innholdskontrollobjekter (Innholdskontrollobjekter)
ContentControl gir en måte å kontrollere inndata og gjengivelse av tekst og andre typer innhold i et Word-dokument. ContentControl kan vise mange forskjellige typer brukergrensesnitt som er optimalisert for bruk i Word-dokumenter, som flermeldingstekstkontroller, datovelgere eller kombinasjonsbokser. Du kan også bruke ContentControl for å hindre brukere i å redigere visse deler av et dokument eller en mal.
Visual Studio utvider ContentControl-objektet til flere forskjellige vertskontroller. Mens ContentControl-objektet viser alle de forskjellige typene UI som er tilgjengelige for innholdskontroller, tilbyr Visual Studio en egen type for hver innholdskontroll. For eksempel kan du bruke RichTextContentControl til å lage en tekstkontroll med flere meldinger, eller du kan bruke DatePickerContentControl til å lage en datovelger. Disse vertskontrollene oppfører seg på lignende måte som native ContentControls, men de har også ekstra event- og databindingsmuligheter.
Bokmerkeobjekt
Bokmerkeobjektet representerer tilstøtende områder i et dokument med både start- og sluttposisjon. Du kan bruke bokmerker for å markere en plassering i dokumentet eller som en beholder for den kinesiske versjonen av dokumentet. Et bokmerkeobjekt kan inneholde innsettingspunkter eller være like stort som hele dokumentet. Bokmerke har følgende egenskaper som skiller det fra Range-objekter:
- Du kan navngi bokmerker når du designer.
- Bokmerkeobjektet lagres sammen med dokumentet, så det slettes ikke når koden slutter å kjøre eller dokumentet lukkes.
- Få tilgang til View-egenskapen ved å sette View-egenskapen til falsk eller sann.
- Visual Studio utvider Bookmark-objektet ved å tilby en Bookmark host-kontroll. Bokmerkevert-kontroller oppfører seg på lignende måte som native Bookmark, men de har også ekstra event- og databindingsmuligheter. Du kan binde data til en bokmerkekontroll på et dokument på samme måte som du binder data til en tekstbokskontroll i et Windows-skjema.
Lag et Word VSTO-tillegg
Etter å ha forstått de grunnleggende konseptene, åpne VS 2022 for å lage et nytt Word VSTO-tillegg, som vist i figuren nedenfor:
Lag et visuelt bånd som vist i følgende figur:
Dobbeltklikk Ribbon1.cs for å åpne, fjern standardfanen, og dra inn en ny fane, som vist nedenfor:
Dra en gruppe- og en knappekontroll inn i den nye fanen, som vist nedenfor:
Dobbeltklikk på den nyopprettede knappen for å opprette en klikk-hendelse med følgende kode:
(Slutt)
|
Publisert på 30.04.2023 20:53:15
|
|
|
|
Vert|
Publisert på 30.04.2023 23:32:31
|
Publisert på 02.05.2023 10:30:48