Средства разработки приложений


Компонент ExcelDDEConnection.


Компонент ExcelDDEConnection представляет готовое решение, позволяющее организовать «горячий» канал DDE между приложением .NET и Excel. Компонент состоит из нескольких классов, главный из которых - ExcelDDEHotConnection. Экземпляр данного класса автоматически инициализируется в библиотеке DDEML при создании и отключается от ее при завершении своего существования.

Ниже приведены основные методы и свойства класса ExcelDDEHotConnection:

Название

Описание

ExcelDDEHotConnection()

Конструктор. Осуществляет регистрацию в библиотеке DDEML

TopicDescriptorCollection Topics

Свойство. Ссылка на коллекцию разделов. Раздел адресуется названием книги и названием страницы

void Dispose()

Завершить работу объекта. Закрывает все каналы и производит отключение от библиотеки DDEML

event AdviseDelegate Data

Событие. Происходит при изменении содержимого любой из подписанных ячеек. Событие вызывается для каждой изменившейся ячейки.

Коллекция разделов TopicDescriptorCollection.

Коллекция разделов представляет собой набор объектов, описывающий разделы. При добавлении раздела в коллекцию, происходит автоматическое создание канала, а при удалении – закрытие канала. Коллекция не допускает дублирование одинаковых разделов. Раздел добавляется в коллекцию только в том случае, если удалось создать канал для этого раздела.

Название Описание

Result Add(TopicDescriptor descriptor)

Добавить дескриптор раздела в коллекцию. В качестве параметра передается дескриптор раздела. При добавлении происходит попытка создать канал с разделом, который описывает данный дескриптор. Если такой раздел уже есть в коллекции, или не удалось создать канал, то данный дескриптор добавлен не будет. В первом случае функция вернет код возврата Result.AlreadyExists, а во втором случае – Result.ConversStartError. В случае успешного выполнения, дескриптор раздела добавляется в коллекцию, а метод возвращает код возврата Result.OK.

Result Add(string book, string sheet)

Добавить дескриптор раздела в коллекцию. В качестве параметра передается название книги book и страницы - sheet. При добавлении происходит попытка создать канал с разделом, который описывает дескриптор. Если такой раздел уже есть в коллекции, или не удалось создать канал, то данный дескриптор добавлен не будет. В первом случае функция вернет код возврата Result.AlreadyExists, а во втором случае – Result.ConversStartError. В случае успешного выполнения, дескриптор раздела добавляется в коллекцию, а метод возвращает код возврата Result.OK.

Result Remove(TopicDescriptor descriptor)

Удалить дескриптор из коллекции. В качестве параметра передается дескриптор раздела. При удалении происходит закрытие канала связи, при этом для всех ячеек раздела выполняется транзакция завершения. Если дескриптор не существовал в коллекции, метод вернет код возврата Result.NonExistingItem, а в случае ошибок, возникших при закрытии канала – Result.ConversStopError, но при этом дескриптор будет все равно удален из раздела. В случае удачного выполнения дескриптор удаляется из коллекции, а метод возвращает код Result.OK.

Result Remove(string book, string sheet)

Удалить дескриптор из коллекции. В качестве параметра передается название книги - book и страницы - sheet. При удалении происходит закрытие канала связи, при этом для всех ячеек раздела выполняется транзакция завершения. Если дескриптор не существовал в коллекции, метод вернет код возврата Result.NonExistingItem, а в случае ошибок, возникших при закрытии канала – Result.ConversStopError, но при этом дескриптор будет все равно удален из раздела. В случае удачного выполнения дескриптор удаляется из коллекции, а метод возвращает код Result.OK;

void Clear()

Метод удаляет все дескрипторы разделов из коллекции, при этом происходит закрытие всех каналов.

void Dispose()

Метод завершает работу коллекции – закрывает все каналы и удаляет все дескрипторы.

int Count

Свойство возвращает количество разделов, зарегистрированных в коллекции.

TopicDescriptor this[string book, string sheet]

Возвращает дескриптор по названию книги и страницы.

TopicDescriptor this[int index]

Возвращает дескриптор по его порядковому номеру в коллекции.

TopicDescriptor this[string topic]

Возвращает дескриптор по названию раздела в формате Excel.




Начало  Назад  Вперед



Книжный магазин