Un ghid practic

Controale de conținut pot fi adăugate la un document programatic în timpul rulării prin utilizarea unor metode ale clasei ThisDocument Controale de proprietate în proiectul dumneavoastră. Fiecare metodă are trei suprasarcini pe care le puteți utiliza pentru a adăuga conținutul următoarelor modalități de control:

Adăugați un control la selecția curentă;

Adăugați comanda la intervalul specificat;

Adăugați un control bazat pe un control al conținutului gestionat pe un document.

Când închideți un document, controalele de conținut create în mod dinamic nu sunt salvate în document. Cu toate acestea, controlul conținutului neadministrat rămâne în document. Puteți re-crea un control de conținut bazat pe un control de conținut gestionat când deschideți din nou documentul. Pentru informații suplimentare, consultați Adăugați controale la Documente Office la Timp de execuție.

Adăugați un control de conținut la selecția curentă

Utilizați metoda ControlCollection numită Adăugare <класс элемента управления> (În cazul în care clasa de control - este numele de control clasa de conținut pe care doriți să adăugați, de exemplu, AddRichTextContentControl) și un parametru pentru numele noului control.

Următorul exemplu de cod utilizează metoda ControlCollection. AddRichTextContentControl (String). Pentru a adăuga un nou RichTextContentControl în partea de sus a documentului. Pentru a executa acest cod, adăugați codul în clasa ThisDocument în proiectul dumneavoastră și apelați metoda AddRichTextControlAtSelection ThisDocument_Startup de tratare a evenimentelor.

Adăugarea unui control la intervalul specificat

Utilizați metoda ControlCollection numită Adăugare <класс элемента управления> (unde clasa de control este numele clasei de control de conținut pe care doriți să o adăugați, de exemplu, AddRichTextContentControl) și parametrul Microsoft.Office.Interop.Word. Gama.

Următorul exemplu de cod utilizează metoda ControlCollection. AddRichTextContentControl (interval, șir). Pentru a adăuga un nou RichTextContentControl în partea de sus a documentului. Pentru a rula acest cod, adăugați codul în clasa ThisDocument în proiect și apelați metoda AddRichTextControlAtRange a manualului de evenimente ThisDocument_Startup.

Adăugarea unui control de conținut bazat pe un control al conținutului gestionat

Utilizați metoda ControlCollection numită Adăugare <класс элемента управления> (În cazul în care clasa de control - este numele de control clasa de conținut pe care doriți să adăugați, de exemplu, AddRichTextContentControl) și parametrul Microsoft.Office.Interop.Word.ContentControl.

Următorul exemplu de cod utilizează metoda ControlCollection. AddRichTextContentControl (ContentControl, String) este folosit pentru a crea un nou obiect RichTextContentControl pentru fiecare control formatat de text formatat în document. Pentru a executa acest cod, adăugați codul în clasa ThisDocument în proiectul dumneavoastră și a apela CreateRichTextControlsFromNativeControls metoda ThisDocument_Startup tratare a evenimentului.

Puteți adăuga elemente de control al conținutului programabil la orice document deschis, la momentul executării, cu ajutorul programului de completare VSTO. Pentru a face acest lucru, creați Document master. bazat pe un document deschis, apoi folosiți metodele de proprietăți ale acestui element principal. Fiecare metodă are trei suprasarcini pe care le puteți utiliza pentru a adăuga un control de conținut în următoarele moduri:

Adăugați un control la selecția curentă;

Adăugați comanda la intervalul specificat;

Adăugați un control bazat pe un control al conținutului gestionat pe un document.

Când închideți un document, controalele de conținut create în mod dinamic nu sunt salvate în document. Cu toate acestea, controlul conținutului neadministrat rămâne în document. Puteți re-crea un control de conținut bazat pe un control de conținut gestionat când deschideți din nou documentul. Pentru mai multe informații, consultați Salvarea controalelor dinamice în Documentele Office.

Pentru mai multe informații despre crearea unui element-cheie în proiectul VSTO add cm., A se vedea Extinderea documente Word și Excel registrele de lucru în VSTO add-in-uri în timpul rulării.

Articole similare