Zahteve: Uporabite VSTO za razvoj preprostega vtičnika za Office, na primer za pridobitev vtičnika dolžine kitajskega znaka v Wordu.
Model objektov v besedilu
Word ponuja na stotine predmetov za interakcijo. Ti objekti so organizirani v hierarhiji, ki strogo sledi uporabniškemu vmesniku. Objekt aplikacije je na vrhu hierarhije. Ta objekt predstavlja trenutno instanco Worda. Objekt Application vsebuje objekte Dokument, Selection, Zaznamk in Obseg. Vsak od teh objektov ima več metod in lastnosti, ki jih je mogoče uporabiti za manipulacijo in interakcijo z objektom.
Naslednja slika prikazuje pogled na te objekte v hierarhiji modelov objektov v Wordu.
Dokumentacija:Prijava do hiperpovezave je vidna.
Objekt aplikacije
Objekt Application predstavlja Word aplikacijo in je starš vseh drugih objektov. Njeni člani se običajno nanašajo na Besedo kot celoto. Njegove lastnosti in metode lahko uporabite za nadzor Wordovega okolja.
V projektu dodatka VSTO lahko dostopate do objekta ThisAddIn z uporabo polj Application razreda Application.
V projektu na ravni dokumenta je objekt ThisDocument dostopen z uporabo lastnosti Application razreda Application.
Objekt dokumenta
Objekt Dokument je središče programiranja v Wordu. Predstavlja dokument in vso njegovo vsebino. Ko odprete dokument ali ustvarite nov dokument, se ustvari nov objekt Dokument, ki se doda v zbirko aplikacij objekta Dokumenti. Dokument s poudarkom je znan kot aktiven dokument. Predstavlja ga lastnost Application objekta ActiveDocument.
Ko ustvarite projekt na ravni dokumenta, lahko do člana ThisDocument dostopate z uporabo razreda Document, generiranega v projektu. Objekt ThisDocument je dostopen z uporabo ključne besede Me ali this za kodo v razredu Document ali z uporabo Globals.ThisDocument za kodo zunaj razreda ThisDocument.
Izbirni objekt
Predmet Selection predstavlja trenutno izbrano regijo. Ko izvajate dejanje v uporabniškem vmesniku Worda, kot je krepko besedilo, lahko izberete ali označite besedilo in nato uporabite oblikovanje. Objekt Selection je vedno prisoten v dokumentu. Če ni nič prekljukano, to označuje mesto vstavljanja. Poleg tega lahko izbrana vsebina vsebuje več nesosednjih blokov besedila.
Objekt dosega
Objekt Range predstavlja sosednja območja v dokumentu in je definiran z začetnim in končnim položajem znakov. Ni omejen na en sam objekt Range. V istem dokumentu lahko določite več objektov Range. Objekti na razdalji imajo naslednje značilnosti:
- Lahko vsebuje le posamezne točke vstavljanja ali pa obseg besedila ali celoten dokument.
- Vključuje netiskane znake, kot so presledki, zavihki in označevalci odstavkov.
- To je lahko območje, ki ga predstavlja trenutno izbrana vsebina, ali območje, ki se razlikuje od te vsebine.
- V dokumentu ni vidna, za razliko od izbrane vsebine, ki je vedno vidna.
- Ni shranjena z dokumentacijo in obstaja le, ko je koda še v teku.
- Ko je besedilo vstavljeno na konec območja, Word samodejno razširi razpon, da vključuje vstavljeno besedilo.
Objekti nadzora vsebine (Objekti nadzora vsebine)
ContentControl omogoča nadzor nad vnosom in prikazom besedila ter drugih vrst vsebin znotraj Wordovega dokumenta. ContentControl lahko prikaže veliko različnih vrst uporabniškega vmesnika, ki so optimizirane za uporabo v Wordovih dokumentih, kot so večsporočilni besedilni kontrolniki, izbirniki datumov ali kombinirani okvirji. Lahko uporabite tudi ContentControl, da preprečite uporabnikom urejanje določenih delov dokumenta ali predloge.
Visual Studio razširi objekt ContentControl na več različnih kontrol gostitelja. Medtem ko objekt ContentControl prikazuje vse različne vrste uporabniških vmesnikov, ki so na voljo za nadzor vsebine, Visual Studio ponuja drugačno vrsto za vsak nadzor vsebine. Na primer, lahko uporabite RichTextContentControl za ustvarjanje večsporočilnega besedilnega nadzora ali pa DatePickerContentControl za ustvarjanje izbire datumov. Ti gostiteljski kontrolniki delujejo podobno kot nativni ContentControls, vendar imajo tudi dodatne možnosti vezave dogodkov in podatkov.
Objekt zaznamkov
Objekt Zaznamk predstavlja sosednja območja v dokumentu z začetnim in končnim položajem. Zaznamke lahko uporabite za označevanje lokacije v dokumentu ali kot posodo za kitajsko različico dokumenta. Objekt Zaznamk lahko vsebuje točke vstavljanja ali pa je velik kot celoten dokument. Zaznamk ima naslednje značilnosti, ki ga ločijo od objektov Range:
- Pri oblikovanju lahko poimenujete zaznamke.
- Objekt Zaznamk se shrani skupaj z dokumentom, zato ni izbrisan, ko koda preneha delovati ali je dokument zaprt.
- Do lastnosti Ogled dostopate tako, da nastavite lastnost Pogled na napačno ali resnično.
- Visual Studio razširi objekt Zaznamk z zagotavljanjem nadzora gostitelja zaznamka. Kontrole gostitelja zaznamkov delujejo podobno kot nativni Bookmark, vendar imajo tudi dodatne možnosti vezave dogodkov in podatkov. Podatke lahko povežete z kontrolnikom zaznamkov na dokumentu na enak način, kot podatke vežete na kontrolnik besedilnega polja v Windows Form.
Ustvarite dodatek za Word VSTO
Po razumevanju osnovnih konceptov odprite VS 2022 in ustvarite nov dodatek za Word VSTO, kot je prikazano na spodnji sliki:
Ustvarite vizualni trak, kot je prikazano na naslednji sliki:
Dvojni klik Ribbon1.cs odpre, odstranite privzeti zavihek in povlecite nov zavihek, kot je prikazano spodaj:
V zavihek novega zavihka povlecite skupino in gumb za gumb, kot je prikazano spodaj:
Dvakrat kliknite na novo ustvarjeni gumb, da ustvarite klik dogodek z naslednjo kodo:
(Konec)
|
Objavljeno na 30. 04. 2023 20:53:15
|
|
|
|
Najemodajalec|
Objavljeno na 30. 04. 2023 23:32:31
|
Objavljeno na 2. 05. 2023 10:30:48