Prasības: izmantojiet VSTO, lai izstrādātu vienkāršu Office spraudni, piemēram, iegūtu Word ķīniešu rakstzīmju garuma spraudni.
Word objekta modelis
Word piedāvā simtiem objektu, ar kuriem mijiedarboties. Šie objekti ir sakārtoti hierarhijā, kas stingri atbilst lietotāja interfeisam. Lietojumprogrammas objekts atrodas hierarhijas augšpusē. Šis objekts attēlo pašreizējo Word instanci. Lietojumprogrammas objekts satur objektus Dokuments, Atlase, Grāmatzīme un Diapazons. Katram no šiem objektiem ir vairākas metodes un īpašības, ko var izmantot, lai manipulētu un mijiedarbotos ar objektu.
Nākamajā attēlā ir parādīts šo objektu skats Word objektu modeļa hierarhijā.
Dokumentācija:Hipersaites pieteikšanās ir redzama.
Lietojumprogrammas objekts
Lietojumprogrammas objekts apzīmē Word lietojumprogrammu un ir visu pārējo objektu vecāks. Tās locekļi parasti tiek lietoti Word kopumā. Jūs varat izmantot tās īpašības un metodes, lai kontrolētu Word vidi.
VSTO pievienojumprogrammas projektā varat piekļūt objektam ThisAddIn, izmantojot lietojumprogrammas klases laukus.
Dokumenta līmeņa projektā objektam ThisDocument var piekļūt, izmantojot lietojumprogrammas klases rekvizītu Application.
Dokumenta objekts
Dokumenta objekts ir Word programmēšanas centrs. Tas attēlo dokumentu un visu tā saturu. Atverot dokumentu vai izveidojot jaunu dokumentu, tiek izveidots jauns dokumenta objekts un pievienots objekta Dokumenti lietojumprogrammu kolekcijai. Dokuments ar fokusu tiek dēvēts par aktīvu dokumentu. To attēlo objekta ActiveDocument rekvizīts Lietojumprogramma.
Veidojot dokumenta līmeņa projektu, varat piekļūt ThisDocument dalībniekam, izmantojot projektā ģenerēto klasi Document. Objektam ThisDocument var piekļūt, izmantojot atslēgvārdu Me vai this kodam klasē Document vai izmantojot Globals.ThisDocument kodam ārpus klases ThisDocument.
Atlases objekts
Atlases objekts apzīmē pašreiz atlasīto reģionu. Veicot darbību Word lietotāja interfeisā, piemēram, treknrakstā, varat atlasīt vai iezīmēt tekstu un pēc tam lietot formatējumu. Atlases objekts vienmēr ir dokumentā. Ja nekas nav atzīmēts, tas norāda ievietošanas punktu. Turklāt atlasītais saturs var saturēt vairākus blakus neesošus teksta blokus.
Diapazona objekts
Objekts Diapazons attēlo blakus esošos apgabalus dokumentā, un to definē sākuma un beigu rakstzīmju pozīcijas. Tas neaprobežojas tikai ar vienu diapazona objektu. Vienā dokumentā var definēt vairākus diapazona objektus. Diapazona objektiem ir šādas īpašības:
- Tajā var būt tikai atsevišķi ievietošanas punkti vai teksta diapazons vai viss dokuments.
- Tajā ir iekļautas nedrukātas rakstzīmes, piemēram, atstarpes, tabulatori un rindkopu marķieri.
- Tas var būt apgabals, ko attēlo pašreiz atlasītais saturs, vai apgabals, kas atšķiras no šī satura.
- Tas nav redzams dokumentā, atšķirībā no izvēlētā satura, kas vienmēr ir redzams.
- Tas netiek saglabāts kopā ar dokumentāciju un pastāv tikai tad, kad kods darbojas.
- Kad teksts tiek ievietots diapazona beigās, programma Word automātiski paplašina diapazonu, iekļaujot ievietoto tekstu.
Satura vadīklas objekti (satura vadīklas objekti)
ContentControl nodrošina veidu, kā kontrolēt teksta un cita veida satura ievadi un atveidošanu Word dokumentā. ContentControl var parādīt daudzus dažādus lietotāja interfeisa tipus, kas ir optimizēti lietošanai Word dokumentos, piemēram, vairāku ziņojumu teksta vadīklas, datumu atlasītājus vai kombinētos lodziņus. Varat arī izmantot ContentControl, lai neļautu lietotājiem rediģēt noteiktas dokumenta vai veidnes sadaļas.
Visual Studio paplašina objektu ContentControl uz vairākām dažādām resursdatora vadīklām. Kamēr objekts ContentControl parāda visus dažādos satura vadīklām pieejamos lietotāja interfeisa tipus, Visual Studio katrai satura vadīklai nodrošina atšķirīgu tipu. Piemēram, varat izmantot RichTextContentControl, lai izveidotu vairāku ziņojumu teksta vadīklu, vai varat izmantot DatePickerContentControl, lai izveidotu datuma atlasītāju. Šīs resursdatora vadīklas darbojas līdzīgi kā vietējās ContentControls, taču tām ir arī papildu notikumu un datu saistīšanas iespējas.
Grāmatzīmes objekts
Objekts Grāmatzīme attēlo blakus esošos apgabalus dokumentā ar sākuma un beigu pozīcijām. Grāmatzīmes var izmantot, lai atzīmētu vietu dokumentā vai kā konteineru dokumenta ķīniešu versijai. Grāmatzīmes objekts var saturēt iespraušanas punktus vai būt tikpat liels kā viss dokuments. Grāmatzīmei ir šādas īpašības, kas to atšķir no diapazona objektiem:
- Projektēšanas laikā varat nosaukt grāmatzīmes.
- Grāmatzīmes objekts tiek saglabāts kopā ar dokumentu, tāpēc tas netiek izdzēsts, kad kods pārtrauc darboties vai dokuments tiek aizvērts.
- Piekļūstiet rekvizītam Skats, iestatot rekvizītu Skats uz false vai true.
- Visual Studio paplašina grāmatzīmes objektu, nodrošinot grāmatzīmes resursdatora vadīklu. Grāmatzīmju resursdatora vadīklas darbojas līdzīgi kā vietējā grāmatzīme, taču tām ir arī papildu notikumu un datu saistīšanas iespējas. Datus var saistīt ar dokumenta grāmatzīmju vadīklu tādā pašā veidā, kā saistāt datus ar tekstlodziņa vadīklu Windows veidlapā.
Word VSTO pievienojumprogrammas izveide
Pēc pamatjēdzienu izpratnes atveriet VS 2022, lai izveidotu jaunu Word VSTO pievienojumprogrammu, kā parādīts zemāk redzamajā attēlā:
Izveidojiet vizuālo lenti, kā parādīts šajā attēlā:
Veiciet dubultklikšķi uz Ribbon1.cs, lai atvērtu, noņemiet noklusējuma cilnes cilni un velciet jaunu cilni, kā parādīts tālāk.
Velciet grupas un pogas vadīklu uz jaunās cilnes cilni, kā parādīts tālāk.
Veiciet dubultklikšķi uz jaunizveidotās pogas pogas, lai izveidotu klikšķa notikumu ar šādu kodu:
(Beigas)
|
Publicēts 30.04.2023 20:53:15
|
|
|
|
Saimnieks|
Publicēts 30.04.2023 23:32:31
|
Publicēts 02.05.2023 10:30:48