0 / 0 / 0 Регистрация: 29.11.2018 Сообщений: 51 |
|
1 |
|
09.10.2019, 21:00. Показов 1089. Ответов 3
я создаю шаблон надстройки VSTO для Microsoft Word, затем добавляю форму в которой имеются несколько элементов textBox. Как я могу перенести введенную в них информацию в Word при нажатии на кнопку? ещё, если я ввожу, например, в 1 textBox = a, во 2 textBox = b, могу ли я как то сложить их, и сумму также вывести в документ Word?
0 |
BlackEric 88 / 62 / 18 Регистрация: 09.12.2015 Сообщений: 174 |
||||
10.10.2019, 17:10 |
2 |
|||
Берете и вставляете значение в документ. На месте курсора
0 |
0 / 0 / 0 Регистрация: 29.11.2018 Сообщений: 51 |
|
10.10.2019, 20:00 [ТС] |
3 |
Я создаю надстройку VSTO для Microsoft Word с помощью visual studio. Как мне сделать так, чтобы при нажатии на кнопку в ленте word открывалось окно windows forms, а затем введенные значения в эту форму отображались на листе документа?
0 |
0 / 0 / 0 Регистрация: 29.11.2018 Сообщений: 51 |
|||||
10.10.2019, 20:29 [ТС] |
4 |
||||
а если я добавляю элемент управления «лента», которая содержит кнопку, как я могу открыть окно windows forms для взаимодействия с пользователем, нажав на эту кнопку?
0 |
Модель модулей расширения Microsoft Office 2000
Интерфейс IDTExtensibility2
Внедрение в объектную модель Office
COM Events
Введение
Базовый класс обработчика COM-событий
Обработчик событий от CommandBarButton
Регистрация модулей
Пишем COM Add-In
Библиотеки типов Office 2000
Создаем COM-сервер
Отладка модулей расширения
Реализуем функциональность
Написание надстроек, работающих с несколькими приложениями Office
Модель модулей расширения Microsoft Office 2000
В Office 2000
Microsoft ввела единый API для написания
подключаемых модулей, расширяющих
функциональные возможности пакета. Теперь
стало возможно написание модулей, которые
интегрируются с
любым из приложений пакета. Разработанный
набор интерфейсов упрощает создание
расширений, позволяя программисту
сконцентрироваться на функциональности, а
не на изучении особенности каждого из
приложений.
Новая модель подключаемых модулей была
названа COM
Add-Ins.
Как следует из названия, модуль расширения (Add-In)
представляет собой COM-сервер,
который специальным образом
зарегистрирован в операционной системе.
При загрузке приложение пакета Office
загружает
зарегистрированные расширения и вызывает
их методы, позволяя установить обработчики
на необходимые для их дальнейшего
функционирования события. По завершении
работы приложение Office
извещает об этом модули расширения,
позволяя последним корректно освобождать
ресурсы.
Общение модулей расширения с загрузившим
их приложением происходит с помощью
объектной модели Microsoft
Office.
Использование COM Add-In позволяет в корне изменить подходы к интеграции приложений
с Microsoft Office. Например, вместо того чтобы вызывать Word для генерации
отчетов, можно, наоборот, встроить в него меню со списком отчетов, а по выбору
пользователем нужного отчета — запросить данные из базы данных и сформировать
по ним документ.
Интерфейс IDTExtensibility2
Ключевым моментом в написании COM
Add-In
является реализация им интерфейса IDTExtensibility2,
определенного следующим образом:
type IDTExtensibility2 = interface(IDispatch) ['{B65AD801-ABAF-11D0-BB8B-00A0C90F2744}'] procedure OnConnection(const HostApp: IDispatch; ext_ConnectMode: Integer; const AddInInst: IDispatch; var custom: PSafeArray); safecall; procedure OnDisconnection(ext_DisconnectMode: Integer; var custom: PSafeArray); safecall; procedure OnAddInsUpdate(var custom: PSafeArray); safecall; procedure OnStartupComplete(var custom: PSafeArray); safecall; procedure BeginShutdown(var custom: PSafeArray); safecall; end;
После загрузки зарегистрированного в
качестве расширения COM-сервера
Office
запрашивает у него этот интерфейс и, если он
реализован, вызывает соответствующие
методы, позволяя расширению реализовать
свою функциональность.
Рассмотрим
методы IDTExtensibility2 подробнее:
procedure OnConnection( const HostApp: IDispatch; ext_ConnectMode: Integer; const AddInInst: IDispatch; var custom: PSafeArray ); safecall;
Вызывается при загрузке модуля
расширения. В этот момент
можно произвести требуемую инициализацию,
добавить или удалить необходимые
интерфейсные элементы, установить
обработчики событий и т.п.
Параметры, передаваемые методу:
HostApp |
Ссылка |
ext_ConnectMode |
Константа, ext_cm_AfterStartup ext_cm_External ext_cm_Startup ext_cm_CommandLine |
AddinInst |
Ссылка на интерфейс IDispatch |
Custom |
Здесь и далее — в Microsoft |
procedure OnDisconnection(ext_DisconnectMode: Integer; var custom: PSafeArray); safecall;
Вызывается
при выгрузке модуля расширения. Этот
метод должен произвести освобождение
занятых ресурсов и прочие процедуры по
завершении работы COM-сервера.
Параметр
ext_DisconnectMode информирует о причине выгрузки
COM-сервера и может принимать следующие
значения:
ext_dm_HostShutdown
– приложение завершает работу;
ext_dm_UserClosed
– модуль расширения выгружен
пользователем.
procedure OnAddInsUpdate(var custom: PSafeArray); safecall;
Вызывается при изменении списка
загруженных модулей расширений. COM-сервер
может проанализировать коллекцию
расширений приложения и предпринять
необходимые действия, требующие
взаимодействия с другими
модулями расширений.
procedure OnStartupComplete(var custom: PSafeArray); safecall;
Вызывается по завершении инициализации приложения. Те модули расширений, которые
должны предоставлять интерфейс пользователя при запуске приложения, должны делать
это в методе OnStartupComplete, когда приложение полностью завершило этап инициализации.
procedure BeginShutdown(var custom: PSafeArray); safecall;
Вызывается в начале процесса завершения приложения, позволяя расширениям предпринять
в этот момент какие-либо действия.
Внедрение в объектную модель Office
Как было показано в предыдущем разделе, расширению доступен интерфейс IDispatch
вызывающего приложения. Таким образом, оно может модифицировать интерфейс этого
приложения, добавляя и удаляя необходимые интерфейсные элементы, создавать документы,
вызывать различные методы для работы с ними. Однако, как правило, помимо этого
необходимо обеспечить реакцию на различные события в вызывающем приложении (такие
как изменение документа или нажатие кнопки на панели инструментов). Для этого
Add-In должен установить обработчик соответствующего события. Прежде чем перейти
к вопросам реализации, совершим небольшой экскурс по событиям COM и их обработчикам.
COM Events
Введение
Если COM-объект
хочет получать информацию о событиях в
другом COM-объекте, то он должен уведомить об
этом объект-источник событий,
зарегистрировав себя в списке объектов-получателей
уведомлений о событиях. Модель COM
предоставляет для этого стандартный
механизм.
Объект-источник
событий (в нашем случае – приложение Office,
документ, кнопка на панели инструментов и т.п.)
реализует интерфейс IConnectionPointContainer. Объект,
нуждающийся в оповещении о событиях, должен
запросить у источника этот интерфейс, затем
при помощи метода FindConnectionPoint
получить «точку подключения» – интерфейс IConnectionPoint
и посредством вызова метода Advise
зарегистрировать в этой точке подключения
ссылку на свою реализацию интерфейса IDispatch,
методы которого будут вызываться при
возникновении тех или иных событий в
источнике событий.
Различные
объекты Office определяют интерфейсы, которым
должны соответствовать обработчики их
событий. Так, например, для объекта CommandBarButton
(кнопка на панели инструментов) определен
интерфейс обработчика –
type _CommandBarButtonEvents = dispinterface ['{000C0351-0000-0000-C000-000000000046}'] procedure Click(const Ctrl: CommandBarButton; var CancelDefault: WordBool); dispid 1; end;
Это означает, что при нажатии кнопки будет вызван метод Invoke зарегистрированного
интерфейса-обработчика, с параметром DispId, равным 1. При этом параметр pDispIds
будет содержать указатель на вариантный массив из двух параметров — соответственно
типов CommandBarButton и WordBool.
Базовый класс обработчика COM-событий
Реализуем базовый класс обработчика COM-событий.
Реализация взята из модуля SinkObject.pas,
написанного Бином Ли (Binh Ly, http://www.techvanguards.com/).
type TBaseSink = class(TObject, IUnknown, IDispatch) protected { методы IUnknown } function QueryInterface(const IID: TGUID; out Obj): HResult; stdcall; function _AddRef: Integer; stdcall; function _Release: Integer; stdcall; { методы IDispatch } function GetIDsOfNames(const IID: TGUID; Names: Pointer; NameCount, LocaleID: Integer; DispIDs: Pointer): HResult; virtual; stdcall; function GetTypeInfo(Index, LocaleID: Integer; out TypeInfo): HResult; virtual; stdcall; function GetTypeInfoCount(out Count: Integer): HResult; virtual; stdcall; function Invoke(DispID: Integer; const IID: TGUID; LocaleID: Integer; Flags: Word; var Params; VarResult, ExcepInfo, ArgErr: Pointer): HResult; virtual; stdcall;
private FCookie: Integer; FCP: IConnectionPoint; FSinkIID: TGuid; FSource: IUnknown; function DoInvoke(DispID: Integer; const IID: TGUID; LocaleID: Integer; Flags: Word; var dps: TDispParams; pDispIds: PDispIdList; VarResult, ExcepInfo, ArgErr: Pointer): HResult; virtual; abstract;
public destructor Destroy; override; procedure Connect(pSource : IUnknown); procedure Disconnect; property SinkIID: TGuid read FSinkIID; property Source: IUnknown read FSource; end;
Рассмотрим реализацию ключевых методов этого класса. Метод QueryInterface в
дополнение к стандартной реализации проверяет, нет ли попыток запросить интерфейс
обработчика событий. В этом случае возвращается IDispatch, позволяющий объекту-источнику
событий вызвать метод Invoke:
function TBaseSink.QueryInterface(const IID: TGUID; out Obj): HResult; begin Result := E_NOINTERFACE; Pointer(Obj) := NIL; if GetInterface(IID, Obj) then Result := S_OK; // если запрашивается интерфейс SinkIID - // возвращаем свой IDispatch if not Succeeded(Result) then if IsEqualIID(IID, FSinkIID) then if GetInterface(IDispatch, Obj) then Result := S_OK; end;
Метод Connect регистрирует COM-объект в качестве обработчика событий COM-объекта
pSource. Обращаю внимание, что переменная FCP объявлена как поле класса, поскольку
он должен удерживать счетчик ссылок на «точку подключения», пока она используется.
Если объявить FCP как локальную переменную — по завершении метода Connect произойдет
неявный вызов FCP._Release, что приведет к неправильной работе.
procedure TBaseSink.Connect(pSource: IUnknown); var pcpc: IConnectionPointContainer; begin Disconnect; try // Запрашиваем интерфейс IConnectionPointContainer у объекта- // источника событий OleCheck(pSource.QueryInterface(IConnectionPointContainer, pcpc)); // Запрашиваем интерфейс IConnectionPoint. OleCheck(pcpc.FindConnectionPoint(FSinkIID, FCP)); // Подключаемся к обработчику событий OleCheck(FCP.Advise(Self, FCookie)); // Все прошло успешно - устанавливаем свойство Source FSource := pSource; except raise Exception.Create(Format('Unable to connect %s.'#13'%s', [ClassName, Exception(ExceptObject).Message])); end; end;
Метод Disconnect отключает обработчик событий от объекта-источника.
procedure TBaseSink.Disconnect; begin if FSource = NIL then Exit; try OleCheck(FCP.Unadvise(FCookie)); FCP := NIL; FSource := NIL; except Pointer(FCP) := NIL; Pointer(FSource) := NIL; end; end;
Метод Invoke вызывается при возникновении события в объекте-источнике. Он осуществляет
предварительную обработку параметров и вызывает абстрактный метод DoInvoke,
который должен быть перекрыт в наследниках, реализующих конкретные интерфейсы
обработчиков событий. Реализация такого наследника будет рассмотрена ниже.
Обработчик событий от CommandBarButton
Наследуя
функциональность от базового класса TBaseSink,
обработчики событий конкретных COM-объектов
реализуются перекрытием методов Create и DoInvoke.
Создадим такой обработчик для кнопки на
панели инструментов Office. Он должен
реализовать интерфейс _CommandBarButtonEvents –
type _CommandBarButtonEvents = dispinterface ['{000C0351-0000-0000-C000-000000000046}'] procedure Click(const Ctrl: CommandBarButton; var CancelDefault: WordBool); dispid 1; end;
Объявим класс:
type // Обработчик события нажатия на кнопку TOnCommandButtonClick = procedure (Button: CommandBarButton; var CancelDefault: WordBool) of object;
TCommandButtonEventSink = class(TBaseSink) private FOnClick: TOnCommandButtonClick; protected procedure DoClick(Button: CommandBarButton; var CancelDefault: WordBool); virtual; function DoInvoke (DispID: Integer; const IID: TGUID; LocaleID: Integer; Flags: Word; var dps : TDispParams; pDispIds : PDispIdList; VarResult, ExcepInfo, ArgErr: Pointer): HResult; override; public constructor Create; virtual; property OnClick: TOnCommandButtonClick read FOnClick write FOnClick; end;
В конструкторе установим идентификатор интерфейса обработчика событий, который
мы реализуем.
constructor TCommandButtonEventSink.Create; begin inherited; FSinkIID := _CommandBarButtonEvents; end;
Метод DoClick просто вызывает назначенный классу обработчик события и нужен
для более удобной работы с ним из Delphi.
procedure TCommandButtonEventSink.DoClick(Button: CommandBarButton; var CancelDefault: WordBool); begin if Assigned(FOnClick) then FOnClick(Button, CancelDefault); end;
Ключевым методом является DoInvoke, который для каждого DispId, объявленного
в интерфейсе _CommandBarButtonEvents, должен выполнить соответствующие действия.
function TCommandButtonEventSink.DoInvoke(DispID: Integer; const IID: TGUID; LocaleID: Integer; Flags: Word; var dps: TDispParams; pDispIds: PDispIdList; VarResult, ExcepInfo, ArgErr: Pointer): HResult; begin Result := S_OK; case DispID of // Для этого DispId передаются 2 параметра – CommandBarButton // и WordBool 1 : DoClick(IUnknown(dps.rgvarg^[pDispIds^[0]].unkval) as CommandBarButton, dps.rgvarg^[pDispIds^[1]].pbool^); else Result := DISP_E_MEMBERNOTFOUND; end; end;
Как видим, реализация конкретного обработчика является практически механической
задачей и не должна вызвать проблем. Если в интерфейсе предусмотрено несколько
методов, то следует подставить в оператор case все их DispId. От программиста
требуется лишь аккуратность при отображении массива dps на параметры соответствующих
обработчиков.
Регистрация модулей
COM Add-In — это COM-сервер, который должен быть зарегистрирован в системе,
например, при помощи TRegSvr.exe или RegSvr32.exe. Однако требуется еще один
шаг — регистрация его в Microsoft Office. Для этого необходимо создать в реестре
раздел с именем.
HKEY_CURRENT_USERSoftwareMicrosoftOffice<Имя приложения>AddIns<Имя>
Здесь:
<Имя приложения> — название приложения, к которому подключается Add-In
<Имя> — имя, под которым
зарегистрирован COM-сервер
(название_проекта.имя_класса)
В этом разделе необходимо создать два параметра:
FriendlyName |
Строковый |
LoadBehavior |
Параметр |
Параметр LoadBehavior может принимать одно из следующих значений:
3 |
Add-In |
9 |
Add-In |
16 |
Add-In |
Пишем COM Add-In
Библиотеки типов Office 2000
Для работы с объектной моделью Microsoft Office 2000 нам понадобятся библиотеки
типов, описывающие доступные интерфейсы. Поскольку Delphi 5 поставляется с библиотеками
типов от Office 97, необходимо импортировать нужные модули. В любом случае понадобится
библиотека Office_TLB, остальные (Word_TLB, Excel_TLB и т.п.) могут потребоваться
в зависимости от того, к какому приложению будет писаться модуль расширения.
Для импорта воспользуемся меню Import
TypeLibrary.
После создания модулей с описаниями интерфейсов рекомендую вручную удалить
из них ссылки на модули Graphics и OleCtrls, которые приводят к подключению
к проекту модуля Forms, а при компиляции не нужны.
Создаем COM-сервер
Поскольку COM Add-In является COM-сервером, воспользуемся мастерами Delphi
для его создания. Выберем команду New… -> ActiveX -> ActiveX Library.
Затем добавим в созданную библиотеку Automation Object при помощи мастера New…
-> ActiveX -> Automation Object.
В поле
CoClassName введем имя реализуемого интерфейса
(DTExtensibility2). В
принципе, можно ввести любое имя, требуется
только, чтобы этот интерфейс имел тот же GUID, что и IDTExtensibility,
и аналогичный набор методов.
После того как Delphi создаст новый объект автоматизации, запустим редактор
библиотеки типов. Вначале мы имеем описание интерфейса без методов и со сгенерированным
Delphi значением GUID.
Перейдем на вкладку Text
созданного интерфейса и введем там
следующий текст:
[ uuid(B65AD801-ABAF-11D0-BB8B-00A0C90F2744), version(1.0), helpstring("Dispatch interface for Office2000ComAddIn Object"), dual, oleautomation ]
interface IDTExtensibility2: IDispatch { [id(0x00000001)] HRESULT _stdcall OnConnection( [in] IDispatch * HostApp, [in] long ext_ConnectMode, [in] IDispatch * AddInInst, [in] SAFEARRAY(VARIANT) * custom ); [id(0x00000002)] HRESULT _stdcall OnDisconnection([in] long ext_DisconnectMode, [in] SAFEARRAY(VARIANT) * custom ); [id(0x00000003)] HRESULT _stdcall OnAddInsUpdate( [in] SAFEARRAY(VARIANT) * custom ); [id(0x00000004)] HRESULT _stdcall OnStartupComplete( [in] SAFEARRAY(VARIANT) * custom ); [id(0x00000005)] HRESULT _stdcall BeginShutdown( [in] SAFEARRAY(VARIANT) * custom ); };
Если вы назвали свой класс не DTExtensibility2, а как-то иначе — скорректируйте
название интерфейса. Все остальное, включая uuid, должно быть введено точно
так, как это было описано выше.
Если все введено правильно — в окне Type Library Editor вы должны увидеть пять
методов созданного интерфейса.
Нажмите кнопку «Обновить» и закройте
редактор библиотеки типов — больше он нам
не понадобится. Теперь
откомпилируйте полученный проект и
зарегистрируйте его в Windows при помощи меню
Run->Register COM Server.
При
помощи редактора реестра создайте в
реестре Windows запись для регистрации Add-In с
приложением Microsoft Office. COM Add-In готов!
Отладка модулей расширения
Для работы с модулями расширения
необходимо добавить в меню Microsoft
Office
команду для вызова диспетчера дополнений.
Для этого (на примере Word):
- В меню Сервис выберите команду Настройка, а затем — вкладку Команды.
- В списке Категории выберите категорию Сервис.
- Перетащите команду Надстройки для модели COM… из списка Команды в меню
Сервис. Когда в меню Сервис раскроется список команд, укажите, где в этом
меню должна располагаться команда Надстройки для модели COM…, после чего
отпустите кнопку мыши. - Нажмите кнопку «Закрыть».
При помощи этой команды вызывается окно диспетчера дополнений. Загруженные
дополнения помечены в списке галочкой. Чтобы загрузить надстройку — отметьте
ее и нажмите OK, чтобы выгрузить — снимите отметку.
!Если во время загрузки Add-In произошла ошибка — Office не будет загружать
его при следующем запуске приложения автоматически. Чтобы надстройка снова начала
загружаться — загрузите ее через диспетчер.
Для отладки Com Add-Ins установите в качестве Host Application (меню Run —
> Parameters) приложение Office, к которому подключена надстройка, например
WinWord.exe. После этого установите точку прерывания в одном из методов своего
объекта и запустите приложение. Загрузится Word, и при попадании на точку прерывания
вы окажетесь в отладчике Delphi.
Реализуем функциональность
В
настоящий момент наш Add In умеет только
загружаться, но не может сделать ничего
полезного. Для
примера реализации функциональности
добавим на панель инструментов Office
кнопку, по нажатии которой в текущую
позицию курсора будет вставляться список
файлов выбранной папки.
Для этого дополним наш объект
автоматизации несколькими полями и
методами.
type TDirectoryList = class(TAutoObject, IDTExtensibility2) private Host: WordApplication; FButtonEventsSink: TCommandButtonEventSink; procedure ButtonClick(Button: CommandBarButton; var CancelDefault: WordBool); protected // Реализация IDTExtensibility2 procedure BeginShutdown(var custom: PSafeArray); safecall; procedure OnAddInsUpdate(var custom: PSafeArray); safecall; procedure OnConnection(const HostApp: IDispatch; ext_ConnectMode: Integer; const AddInInst: IDispatch; var custom: PSafeArray); safecall; procedure OnDisconnection(ext_DisconnectMode: Integer; var custom: PSafeArray); safecall; procedure OnStartupComplete(var custom: PSafeArray); safecall; end;
Поле Host будет хранить ссылку на интерфейс WordApplication, необходимый для
работы с объектной моделью Word, поле FButtonEventsSink — ссылку на объект-обработчик
событий от кнопки, реализация которого была рассмотрена в разделе «Обработчик
событий от CommandBarButton», а метод ButtonClick будет вызываться для обработки
нажатия на кнопку.
Реализуем необходимую функциональность
в методах класса TDirectoryList.
const // Уникальный идентификатор кнопки. Можно задать любую уникальную // строку. Для ее генерации удобно воспользоваться средствами // Delphi по генерации GUID (Ctrl+Shift+G) // Этот идентификатор понадобится нам для того, чтобы после // создания кнопки иметь возможность ее найти. BUTTON_TAG = '{1A1552DC-9286-11D3-BCA0-00902759A497}';
procedure TDirectoryList.OnConnection(const HostApp: IDispatch; ext_ConnectMode: Integer; const AddInInst: IDispatch; var custom: PSafeArray); var Bar: CommandBar; Button: CommandBarButton; begin // Сохраняем ссылку на WordApplication для // последующей работы с ней Host := HostApp as WordApplication; // Создаем обработчик событий для кнопки FButtonEventsSink := TCommandButtonEventSink.Create; FButtonEventsSink.OnClick := ButtonClick; // Получаем интерфейс панели инструментов "Форматирование" Bar := Host.CommandBars.Get_Item('Formatting'); // Проверяем наличие на ней нашей кнопки Button := Bar.FindControl(msoControlButton, EmptyParam, BUTTON_TAG, EmptyParam, msoFalse) as CommandBarButton;; if not Assigned(Button) then // Если ее нет – создаем Button := Bar.Controls.Add(msoControlButton, EmptyParam, BUTTON_TAG, 1, EmptyParam) as CommandBarButton; // Подключаем обработчик и устанавливаем свойства кнопки FButtonEventsSink.Connect(Button); Button.Set_Style(msoButtonCaption); Button.Set_Tag(BUTTON_TAG); Button.Set_Caption('Dir'); end;
procedure TDirectoryList.OnDisconnection(ext_DisconnectMode: Integer; var custom: PSafeArray); var Bar: CommandBar; B: CommandBarControl; begin // Уничтожаем обработчик событий кнопки FreeAndNil(FButtonEventsSink); // Ищем свою кнопку Bar := Host.CommandBars.Get_Item('Formatting'); B := Bar.FindControl(msoControlButton, EmptyParam, BUTTON_TAG, EmptyParam, msoFalse) as CommandBarButton; // И удаляем ее if Assigned(B) then B.Delete(msoFalse); end;
procedure TDirectoryList.ButtonClick(Button: CommandBarButton; var CancelDefault: WordBool); var S: String; SR: TSearchRec; D: WordDocument; FindStatus: Integer; begin // Эта процедура вызывается при нажатии на созданную нами кнопку D := Host.ActiveDocument; // Проверяем наличие активного документа if Assigned(D) then begin // Функция BrowseForFolder возвращает путь к выбранной // в диалоге папке. Код функции приведен в модуле с примером // на сопровождающем диске. От использования аналогичной // функции VCL SelectDirectory пришлось отказаться, так как // модуль, в котором она находится, использует Forms if BrowseForFolder(S) then begin with TStringList.Create do try // Получаем список файлов FindStatus := FindFirst(S + '*.*', 0, SR); while FindStatus = 0 do begin Add(SR.Name); FindStatus := FindNext(SR); end; FindClose(SR); // И вставляем его в документ D.ActiveWindow.Selection.InsertAfter(S+#13#13+Text); finally // Освобождаем TStringList Free; end; end; end; end;
Пример работы этой надстройки изображен на рисунке.
Написание надстроек, работающих с несколькими приложениями Office
Поскольку все приложения Office
реализуют одну и ту же модель COM
Add-Ins,
одно и то же расширение может быть
зарегистрировано одновременно для
нескольких приложений. В этом
случае оно должно определять, из какого
приложения оно загружено, и использовать
соответствующую объектную модель.
Определить приложение-владельца можно,
запросив у него соответствующий интерфейс:
procedure TDirectoryList.OnConnection(const HostApp: IDispatch; ext_ConnectMode: Integer; const AddInInst: IDispatch; var custom: PSafeArray); begin if HostApp is WordApplication then // Это Microsoft Word
Также возможно сохранение HostApp
в переменной типа Variant
и использование позднего связывания. В
этом случае надстройка будет работать с
любым приложением Office, имеющим подходящие
по именам методы.
КомпьютерПресс 7’2001
- В меню Сервис выберите команду Настройка.
- Откройте вкладку Команды.
- На вкладке Команды в списке Категории выберите пункт Сервис.
- Перетащите команду надстроек COM на панель инструментов.
- Нажмите кнопку Закрыть, чтобы закрыть диалоговое окно Настройка.
- Нажмите кнопку Надстройки COM, чтобы просмотреть список надстроек COM, загруженных в Word.
Если в окне Надстройки COM содержатся надстройки, временно отключите каждую из них. Для этого снимите флажки всех надстроек COM и нажмите кнопку OK. При повторном запуске Word отключенные надстройки COM не будут загружены.
Если проблема устранена после отключения надстроек COM, то одна из этих надстроек COM является причиной проблемы. Если в списке присутствует несколько надстроек COM, необходимо определить, какая из них вызывает рассматриваемую ошибку. Для этого включайте надстройки COM по одной с последующим перезапуском приложения Word.
Надстройками для модели компонентных объектов называются исполняемые файлы (.exe) или файлы библиотек динамической компоновки (.dll), которые обеспечивают дополнительные возможности в Microsoft Outlook. Широкий набор надстроек для модели компонентных объектов и других программных расширений можно найти на web-узле Microsoft Office. При наличии доступа к Интернету выберите в меню Microsoft Outlook Справка команду Office в Интернете.
Надстройки клиента Microsoft Exchange
Надстройками клиента Microsoft Exchange называются файлы настройки расширений (.ecf), обеспечивающие работу дополнительных функций Microsoft Outlook. Эти надстройки автоматически устанавливаются при установке Microsoft Outlook. Если по какой-либо причине одна из этих надстроек удалена или требуется установить надстройку стороннего поставщика, это можно сделать в любое время. В следующей таблице приведены описания надстроек, имеющихся в Microsoft Outlook.
Имя файла | Описание |
---|---|
Dlgsetp.ecf | Доступ представителей. Добавление вкладки Представители в диалоговом окне Параметры (меню Сервис). |
Dumpster.ecf | Восстановление удаленных элементов. Добавление возможности восстановления удаленных элементов. |
Outex2.ecf | Расширения Microsoft Exchange. Добавление команды Заместитель (меню Сервис). |
Minet.ecf | Почта Интернета. Добавление вкладки Интернет в диалоговом окне Свойства сообщения. |
Mail3.ecf | Расширения Mail 3.0. Включение в Microsoft Outlook расширений, созданных для Microsoft Mail версии 3.0. |
Awfext.ecf | Microsoft Fax. Если ранее была выполнена настройка программы Microsoft At Work, она добавляется в список доступных информационных служб. |
Msfsmenu.ecf | Расширения меню Microsoft Mail 3.x. Включение в Microsoft Outlook расширений меню, созданных для Microsoft Mail 3.x. |
Msfsprop.ecf | Расширения окна свойств Microsoft Mail 3.x. Включение в Microsoft Outlook расширений диалоговых окон, созданных для Microsoft Mail 3.x. |
Outex.ecf | Расширения для удаленной работы Microsoft Exchange. Добавление параметров удаленной почты в окно Почта (панель управления Microsoft Windows). |
Msspc.ecf | Schedule+. Обеспечение совместимости с Microsoft Schedule+. |
Msn.ecf | Microsoft Network. Добавление MSN в список доступных информационных служб. |
Pmailext.ecf | Поддержка Microsoft Windows CE. Добавление поддержки переноса в папку «Входящие» Microsoft Windows CE. |
Scrpxtn.ecf | Поддержка сценариев. Включение агентов сценариев Microsoft Exchange Server. |
Faxext.ecf | Расширения Microsoft Fax. Включение расширений, созданных для Microsoft Fax. |
Ccmxp.ecf | Расширения меню Lotus cc:Mail. Включение расширений меню для Lotus cc:Mail. |
Cserve.ecf | CompuServe. Обеспечение совместимости со службами CompuServe. |
Fldpub.ecf | Публикация папок. Включение публикации папок в Интернете. |
Mtmolmnu.ecf | Диспетчер групп. Добавление поддержки диспетчера групп. |
Olmenu.ecf | Форма TeamStatus. Добавление формы TeamStatus. |
Rwizi.ecf | Мастер правил. Включение мастера правил. |
Добавление или удаление надстройки
- Добавление или удаление надстройки COM.
- В меню Сервис выберите команду Параметры, а затем – вкладку Дополнительно.
- Нажмите кнопку «Дополнительные параметры», а затем – кнопку «COM-надстройки».
- Чтобы включить надстройку, установите флажок рядом с ее названием.
- Если необходимой надстройки COM нет в списке, ее необходимо добавить в Список надстроек. Нажмите кнопку «Добавить», выделите необходимую надстройку (файл .exe или .dll) и нажмите кнопку «OK».
- Чтобы отключить надстройку, снимите флажок рядом с ее названием.
- Чтобы удалить надстройку, снимите флажок рядом с ее названием и нажмите кнопку «Удалить».
- Добавление или удаление надстройки клиента Microsoft Exchange.
- В меню Сервис выберите команду Параметры, а затем – вкладку Дополнительно.
- Нажмите кнопку «Дополнительные параметры», а затем – кнопку «Приложения».
- Нажмите кнопку «Установить» и дважды щелкните необходимый файл конфигурации расширений (.ecf).
- Нажмите кнопку «OK».
- Чтобы отключить надстройку, снимите флажок рядом с ее названием и нажмите кнопку «OK».
- Download source files — 177 Kb
- Download demo files — 353 Kb
Introduction
In this article, we will learn how to create a simple Hello World browser add-in for Microsoft’s applications that supports add-in. A list of such applications is given here:
- Microsoft Word
- Microsoft VSMacros IDE
- Microsoft Visual Studio .NET
- Microsoft Visio
- Microsoft Publisher
- Microsoft Project
- Microsoft PowerPoint
- Microsoft Outlook
- Microsoft FrontPage
- Microsoft Excel
- Microsoft Access
In this article, we will take Microsoft Outlook as an example.
Prerequisites:
You must have the following …
- Microsoft Development Environment 2003 or higher
- Microsoft .NET Framework 2.0
- Office Primary Interop Assemblies (PIAs). For Office XP, click here to download.
Creating the Add-in
- Run the Microsoft Development Environment.
- Go to File> New Project>, a dialog will appear.
- Go to Other Projects> Extensibility Project, select Shared Add-in type project template.
Add-In Wizard
When the Add-in wizard starts, press Next…
Select programming language (example C#), press Next.
Select applications in which you want to host your add-in, press Next.
Provide add-in name and description, press Next.
Choose add-in options, press Next.
Press Finish.
Setup Projects
Two projects will be added automatically.
- Add-in project.
- Setup project.
Creating the Browser Form
- Add a form for the Add-in project, named frmHelloWorld.cs.
- Add a
Label
,TextBox
, and aPictureBox
. - Add a Microsoft web browser control to the form (you can get it by right clicking on the toolbox, selecting Add/Remove Items, and clicking on the “COM Components”: a lot of controls will be listed, select Microsoft Web Browser Control, and press OK.
- With the following code, create a function
go()
:
void go() { try { stbPanel1.Text="Trying to open "+tbURL+"..." ; object obj=new object (); browser.Navigate(tbURL.Text,ref obj,ref obj,ref obj,ref obj); } catch(Exception ex) { } }
Call this function on the PictureBox
‘s Click
event.
Programming for Add-in Connection
Install PIAs and add a reference to the following DLL: Microsoft.Office.Interop.Outlook.DLL.
There will be a file connect.cs in the add-in project, open it. Declare the following items globally:
private Microsoft.Office.Interop.Outlook.Application applicationObject; private object addInInstance; private CommandBarButton btnLaunch;
In the function OnStartupComplete
, write the following code:
public void OnStartupComplete(ref System.Array custom) { CommandBars commandBars = applicationObject.ActiveExplorer().CommandBars; try { btnLaunch= (CommandBarButton) commandBars["Standard"].Controls["HelloWorld"]; } catch { btnLaunch = (CommandBarButton) commandBars["Standard"].Controls.Add(1, System.Reflection.Missing.Value, System.Reflection.Missing.Value, System.Reflection.Missing.Value, System.Reflection.Missing.Value); btnLaunch.Caption = "Hello World Browser!"; btnLaunch.Style = MsoButtonStyle.msoButtonCaption; } btnLaunch.Tag = "This is Hello World Browser!"; btnLaunch.OnAction = "!<EMAILSTATSADDIN.CONNECT>"; btnLaunch.Visible = true; btnLaunch.Click += new _CommandBarButtonEvents_ClickEventHandler( btnLaunch_Click); }
In the function OnBeginShutdown
, write the following code:
public void OnBeginShutdown(ref System.Array custom) { CommandBars commandBars = applicationObject.ActiveExplorer().CommandBars; try { commandBars["Standard"].Controls["HelloWorld"].Delete( System.Reflection.Missing.Value); } catch(System.Exception ex) { } }
Write the following code in the btnLanuch
event handler:
private void btnLaunch_Click(CommandBarButton Ctrl, ref bool CancelDefault) { try { frmHelloWorld objfrmHelloWorld=new frmHelloWorld (); objfrmHelloWorld.Show(); } catch(Exception ex) { } }
Rebuild and Installation
Right click on the setup project, click Rebuild, and it will automatically rebuild the add-in and the setup project. Then, right click on the setup project and click Install.
Running
Run Microsoft Outlook, and you will see “Hello World Browser!” on the toolbar. Click on it and your add-in will start. As you can see here…
Known Issues
After uninstallation, the “Hello World Browser!” button is not removed from the Outlook toolbar.