Reikalavimai: Naudokite VSTO, kad sukurtumėte paprastą "Office" priedą, pvz., gautumėte žodžio kinų simbolių ilgio priedą.
"Word" objekto modelis
"Word" siūlo šimtus objektų, su kuriais galima bendrauti. Šie objektai yra suskirstyti į hierarchiją, kuri griežtai atitinka vartotojo sąsają. Programos objektas yra hierarchijos viršuje. Šis objektas nurodo dabartinį Word egzempliorių. Programos objekte yra objektai Dokumentas, Žymėjimas, Žymelė ir Diapazonas. Kiekvienas iš šių objektų turi daugybę metodų ir savybių, kurias galima naudoti manipuliuojant objektu ir sąveikaujant su juo.
Toliau pateiktame paveikslėlyje parodytas šių objektų rodinys "Word" objektų modelio hierarchijoje.
Dokumentacija:Hipersaito prisijungimas matomas.
Programos objektas
Programos objektas reiškia Word programą ir yra visų kitų objektų pirminis objektas. Jos nariai paprastai taikomi visai "Word". Galite naudoti jo savybes ir metodus "Word" aplinkai valdyti.
VSTO priedo projekte galite pasiekti objektą ThisAddIn naudodami programos klasės laukus Programa.
Dokumento lygio projekte objektą ThisDocument galima pasiekti naudojant programos klasės ypatybę Programa.
Dokumento objektas
Dokumento objektas yra "Word" programavimo centras. Tai reiškia dokumentą ir visą jo turinį. Atidarius dokumentą arba sukūrus naują dokumentą, sukuriamas naujas dokumento objektas ir įtraukiamas į objekto Dokumentai programų rinkinį. Dokumentas su fokusu vadinamas aktyviu dokumentu. Jį vaizduoja objekto ActiveDocument ypatybė Programa.
Kurdami dokumento lygio projektą, galite pasiekti ThisDocument narį naudodami projekte sugeneruotą klasę Document. Objektą ThisDocument galima pasiekti naudojant raktinį žodį Me arba this kodo klasėje Document arba naudojant Globals.ThisDocument kodui, nepriklausančiam ThisDocument klasei.
Pasirinkimo objektas
Pasirinkimo objektas nurodo šiuo metu pasirinktą sritį. Atlikdami veiksmą "Word" vartotojo sąsajoje, pvz., paryškindami tekstą, galite pažymėti arba paryškinti tekstą ir pritaikyti formatavimą. Pasirinkimo objektas visada yra dokumente. Jei nieko nepažymėta, tai rodo įterpimo vietą. Be to, pasirinktame turinyje gali būti keli gretimi teksto blokai.
Diapazono objektas
Diapazono objektas nurodo gretimas dokumento sritis ir yra apibrėžiamas pagal pradžios ir pabaigos simbolių pozicijas. Tai neapsiriboja vienu diapazono objektu. Tame pačiame dokumente galite apibrėžti kelis diapazono objektus. Diapazono objektai turi šias charakteristikas:
- Jame gali būti tik atskiri įterpimo taškai arba teksto diapazonas arba visas dokumentas.
- Jame yra nespausdintų simbolių, tokių kaip tarpai, skirtukai ir pastraipos žymekliai.
- Tai gali būti sritis, kurią vaizduoja šiuo metu pasirinktas turinys, arba sritis, kuri skiriasi nuo šio turinio.
- Jis nėra matomas dokumente, skirtingai nei pasirinktas turinys, kuris visada matomas.
- Jis neįrašomas kartu su dokumentacija ir egzistuoja tik tada, kai kodas veikia.
- Kai tekstas įterpiamas diapazono pabaigoje, programa Word automatiškai išplečia diapazoną, įtraukdama įterptą tekstą.
Turinio valdiklio objektai (turinio valdiklio objektai)
"ContentControl" suteikia būdą valdyti teksto ir kitų tipų turinio įvedimą ir atvaizdavimą "Word" dokumente. "ContentControl" gali rodyti daug skirtingų vartotojo sąsajos tipų, optimizuotų naudoti "Word" dokumentuose, pvz., kelių pranešimų teksto valdiklius, datos parinkiklius arba pasirinktinio įvedimo laukus. Taip pat galite naudoti "ContentControl", kad vartotojai negalėtų redaguoti tam tikrų dokumento ar šablono sekcijų.
"Visual Studio" išplečia objektą "ContentControl" į kelis skirtingus pagrindinio kompiuterio valdiklius. Nors ContentControl objekte rodomi visi skirtingi turinio valdiklių vartotojo sąsajos tipai, "Visual Studio" kiekvienam turinio valdikliui pateikia skirtingą tipą. Pavyzdžiui, galite naudoti RichTextContentControl, kad sukurtumėte kelių pranešimų teksto valdiklį, arba galite naudoti DatePickerContentControl, kad sukurtumėte datos parinkiklį. Šie pagrindinio kompiuterio valdikliai veikia panašiai kaip vietiniai "ContentControls", tačiau jie taip pat turi papildomų įvykių ir duomenų susiejimo galimybių.
Žymelės objektas
Objektas Žymelė nurodo gretimas dokumento sritis su pradžios ir pabaigos padėtimis. Galite naudoti žymeles, norėdami pažymėti vietą dokumente arba kaip dokumento kinų versijos konteinerį. Žymelės objekte gali būti įterpimo taškų arba jis gali būti toks pat didelis kaip visas dokumentas. Žymelė turi šias charakteristikas, išskiriančias ją nuo diapazono objektų:
- Kurdami galite pavadinti žymes.
- Žymelės objektas įrašomas kartu su dokumentu, todėl jis nepanaikinamas, kai kodas nustoja vykdyti arba dokumentas uždaromas.
- Pasiekite ypatybę Rodinys nustatydami ypatybę Rodinys į klaidingą arba teisingą.
- "Visual Studio" išplečia žymelės objektą pateikdama žymelės pagrindinio kompiuterio valdiklį. Žymelių pagrindinio kompiuterio valdikliai veikia panašiai kaip vietinė žymelė, tačiau jie taip pat turi papildomų įvykių ir duomenų susiejimo galimybių. Galite susieti duomenis su dokumento žymelės valdikliu taip pat, kaip susieti duomenis su Windows formos teksto lauko valdikliu.
"Word VSTO" priedo kūrimas
Supratę pagrindines sąvokas, atidarykite VS 2022, kad sukurtumėte naują "Word VSTO" priedą, kaip parodyta paveikslėlyje žemiau:
Sukurkite vaizdinę juostelę, kaip parodyta šiame paveikslėlyje:
Dukart spustelėkite Ribbon1.cs, kad atidarytumėte, pašalinkite numatytąjį skirtuką ir vilkite naują skirtuką, kaip parodyta toliau:
Vilkite grupės ir mygtuko valdiklį į naujo skirtuko skirtuką, kaip parodyta toliau:
Dukart spustelėkite naujai sukurtą mygtuko mygtuką, kad sukurtumėte paspaudimo įvykį su šiuo kodu:
(Pabaiga)
|
Paskelbta 2023-04-30 20:53:15
|
|
|
|
Savininkas|
Paskelbta 2023-04-30 23:32:31
|
Paskelbta 2023-05-02 10:30:48