Свързването към полетата в документ или електронна таблица

Най-новата версия на препратката за офис на добавки на разположение в хранилището на GitHub Добавки.

Тази статия описва как да се създаде автомати в областта на документи и електронни таблици за извършване на четене и запис с тези автомати. Освен това, е описано създаването и заличаване на работещи събития проследяване промените информация или избор на потребителя на елементи на свързване.

Обхват: приложения за Office | Excel | Офис добавки | дума

Достъп до данните, въз основа на задължителен предвижда, че съдържанието на добавки и прозорец на задачите добавка последователен достъп до определена област на документа или електронната таблица с помощта на съответния идентификатор. Първо трябва да инсталирате добавката котвата, което води до един от методите за свързване на площ от документа, уникален идентификационен номер: addFromPromptAsync. addFromSelectionAsync или addFromNamedItemAsync. След създаването на задължителен надстройката може да използвате предоставения идентификатор за достъп до данните, които се съдържат в свързаната област от документа или електронната таблица. Създаване автомати осигурява за добавяне на следната стойност:

Позволява достъп до споделени структури от данни в поддържаните офис приложения, като например: маси, вериги или текст (символи, свързани последователност).

Тя осигурява операциите четене и запис, без да е необходимо потребителят да направи подходящия избор.

Осъществява връзка между надстройката и данните в документа. Автомати, се съхраняват в документа, достъпът до тях може да се извърши по-късно.

Намирането това също ви позволява да се абонирате за данни и изберете събития, свързани с промяната на определена област на документа или електронната таблица. Това означава, че добавката е уведомен само на промените, които се провеждат в рамките на тази конкретна област, за разлика от промените, които засягат целия целия документ или електронна таблица.

Обект автомати осигурява метод getAllAsync. който предоставя достъп до набор от автомати, описани в този документ или лист. Достъп до отделен задължителен е достъпно на идентификационния си номер чрез Bindings.getBindingByIdAsync методи или Office.select. Можете да създадете нов задължителен, както и премахване на съществуващите такива, като се използва един от методите по-долу Обвързвания обект. addFromSelectionAsync. addFromPromptAsync. addFromNamedItemAsync или releaseByIdAsync.

Има три различни видове автомати, които се определят от параметър bindingType при създаването на свързване чрез методи addFromSelectionAsync. addFromPromptAsync или addFromNamedItemAsync:

Anonymous функция, която се предава на функция като параметър обаждане. То се извършва след приключването на операцията. Функцията се извиква с asyncResult трансфер един параметър. който съдържа набор от автомати в документа. Масивът се движи, за да създадете низ, съдържащ задължителните идентификатори. Низът се показва в полето за съобщения.

от идентификатор на свързване като се използва метода от Получаване getByIdAsync автомати обект

Следващият пример показва как да се използва метод за свързване Bindings.getByIdAsync документ чрез определяне на съответния идентификатор. В този пример се приема, че свързването с име "myBinding" се добавя към документа чрез един от методите, описани по-горе в този раздел.

В този пример, първият параметър ID е идентификатора получи свързване.

Anonymous функция, която се предава на функция като втори параметър обратно повикване. То се извършва след приключването на операцията. Функцията се извиква с asyncResult трансфер един параметър. който се състои от състояние на обаждането и задължително идентификатор "myBinding".

чрез свързване идентификатор, получен по метода от Службата изберете обекта

Следващият пример показва как да се използва метода за получаване Office.select Свързването обект в документ чрез определяне на неговата ID линията на селекция. метод Binding.getDataAsync след това се нарича за извличане на данни от въпросното свързване. В този пример се приема, че свързването с име "myBinding" се добавя към документа чрез един от методите, описани по-горе в този раздел.

Ако изберете метод обещание обект успешно връща подвързване обект. Тази задача излага само следните четири метода Свързването обект. getDataAsync. setDataAsync. addHandlerAsync и removeHandlerAsync. Ако обещаете да не се връща свързването обекта. обаждане onError може да се използва за достъп до обект asyncResult.error за допълнителна информация.

Ако искате да се обадите компонент подвързване обект. различни от четирите метода, предоставени от свързването обект обект обещанието (Изберете метод връща), използвайте го, вместо метода на използване на имота getByIdAsync Document.bindings и метода Bindings.getByIdAsync да получите подвързване обект.

Изтриване на идентификатор автомати

Следващият пример показва как да се използва метод за отстраняване на Bindings.releaseByIdAsync свързва документа чрез определяне на съответния идентификатор.

В този пример, първият параметър идентификатора е идентификатора на изтрити котвата.

Anonymous функция, която се предава на функция като Вторият параметър е функция обаждане, което се извършва след операцията завършва. Функцията се извиква с asyncResult трансфер един параметър. който се състои състояние на повикване.

Четене на данни от свързване

Следващият пример показва как да се използва метод Binding.getDataAsync за получаване на данни от съществуващ свързване.

myBinding - променлива, съдържаща съществуващата обвързващ текст в документа. В допълнение, можете да използвате метод Office.select. да получат достъп до свързване на неговия идентификатор и да причини метод getDataAsync. Пример :. Office.select ( "автомати # myBindingID") getDataAsync.

Анонимен функция предава на функцията е обаждане, че се извършва след приключване на операцията. AsyncResult.value имот съдържа myBinding данни. тип стойност зависи от вида на свързване. В този пример, свързването на текста, така че стойността трябва да съдържа низа. За повече примери за използване на автомати матрица и маси видим. В статия на метод Binding.getDataAsync.

Писане на данни в капан

Следващият пример показва как да използвате метод Binding.setDataAsync за дефиниране на данни в съществуващ задължителен.

myBinding - променлива, съдържаща съществуващата обвързващ текст в документа.

В този пример, първият параметър е стойност за определяне на myBinding. Тъй като това е задължителен текст, стойност е низ. Различни видове автомати, получаващи различни типове данни.

Anonymous функция, която се предава на функцията е обратна функция, която се извършва след операцията завършва. Функцията се извиква с asyncResult трансфер един параметър. който съдържа състоянието на резултата.

Откриване на промени в данните или да изберете свързано

Следващият пример показва как да прикачите манипулатор събитие да идентификатор DataChanged котва "MyBinding".

myBinding - променлива, съдържаща съществуващата обвързващ текст в документа.

първи параметър метод eventType binding.addHandlerAsync посочва името на събитието, за да се абонирате. Office.EventType - изброяване на наличните стойности свързващи видове. Office.EventType.BindingDataChanged сравнение с низа "bindingDataChanged".

Функция dataChanged. който се предава на тази функция като втори параметър манипулатор. втори събитието манипулатор, който се изпълнява, когато данните в обвързващо. Функцията се извиква с един параметър eventArgs. който съдържа позоваване на свързване. Това свързване може да бъде използван за получаване на актуализирани данни.

По същия начин, може да се определи, когато потребителят може да променя разпределението свързани чрез добавяне на събитието, за да боравене със събития SelectionChanged задължителен. За да направите това, да определите параметъра метод eventType binding.addHandlerAsync как Office.EventType.BindingSelectionChanged или "bindingSelectionChanged".

Можете да добавите няколко обработват събитие за това събитие, отново предизвиква метод addHandlerAsync и минава допълнителна функция събитие манипулатор за параметъра манипулатор. Това ще работи правилно, тъй като името на всяка функция събитие манипулатор е уникален.

Премахване на манипулатори на събития

За да премахнете манипулатор събитие, обадете метод Binding.removeHandlerAsync. преминаване на типа на събитието като първи параметър eventType. и името на изтрити събитие манипулатор функция като втори параметър манипулатор. Така например, следната функция ще изтрие функция dataChanged манипулатор събитие. добавен в примера в предишния раздел.