Документ Excel — компонент, используется для подключения Excel-документа к проекту, на выходе передает указатель на Excel-файл со специального контакта.
Внешний вид компонента
| Режим проектировщика | Режим оператора |
|---|---|
 |
Не имеет |
Параметры:
Входные
- Вкл\Выкл — подключается/отключается к заданному Excel-файлу.
- Название — название документа, к которому подключаться.
- Вкл\Выкл — включается либо отключается отображение редактируемого Excel-файла.
- Сохранить — при поступлении управляющего импульса на данный контакт, сохраняет подключенный документ.
Выходные
- Книга — поступает указатель на Excel-файл.
Настраиваемые свойства:
Общие свойства (окружение)
Частные свойства (в скобках значение, установленное по умолчанию):
- ExcelDocFileName — название документа, к которому подключаемся, если не указано, создается чистый документ.
- ExcelDocVisible (false) — параметр, устанавливающий видимость редактируемого excel-файла. Принимает значения true/false. Если значение параметра = true, ZETView обратится к MSExcel и откроет указанный файл.
- Password_read — строка, содержащая пароль на открытие указанного Excel-файла.
- Password_write — строка, содержащая пароль на запись данных в указанный Excel-файл.
Параметры:
Для записи данных в Excel-файл, используется совместно с компонентами «Страница Excel» и «Ячейка Excel«. Соединять компоненты нужно в следующей последовательности:
Данный компонент скорее является составным блоком, нежели самостоятельным компонентом. Необходим при работе с excel-файлами. Несмотря на то, что компоненты «Документ Excel«, «Страница Excel» и «Ячейка Excel» имеют входные и выходные контакты одного типа, с этих контактов поступают разнящиеся данные. С компонента «Документ Excel» поступает указатель на книгу, а с компонента «Страница Excel» указатель на страницу. Поэтому нельзя соединить «Документ Excel» и «Ячейка Excel» напрямую.
Компонент стабильно работает с версией Microsoft Office Excel 2007.
Программирование
При использовании компонента в сценарии и программируемом компоненте (скрипте) необходимо учитывать диапазоны значений подаваемых на входные ножки компонента, диапазоны значений свойств компонента, а также диапазоны значений параметров методов компонента.
Параметры:
Входные
- Название — текстовое название документа к которому необходимо подключаться (текст).
Настраиваемые свойства:
Общие свойства (окружение)
Частные свойства (в скобках значение, установленное по умолчанию):
- BSTR ExcelDocFileName — установка и чтение названия документа, к которому подключаемся, если не указано, создается чистый документ (строка).
- VARIANT_BOOL ExcelDocVisible — установка и чтение показать или спрятать программу Excel:
- true — выходное значение выдается при включении показать программу Excel;
- false — выходное значение не выдается при включении спрятать программу Excel.
- BSTR Password_read — установка и чтение пароля на открытие файла (строка).
- BSTR Password_write — установка и чтение пароля на запись данных в файл (строка).
Примечание: ZETExcelDocument.осх если файл указаный у него в свойствах необнаружен он будет пытаться найти его в директории с ехе проекта. если и там его нету он выдаст сообщение что файл не обнаружен в таком то месте и если нажать «Ок» вызовется filedialog с выбором файла для открытия. Предварительно нужно создать и положить в выбранную папку файл с расширением с названием и расширением *.xlsx.
Пример
Проект в SCADA ZETView
Данный компонент используется для создания различных проектов, в том числе таких как тензометрическая система.
Результат работы проекта
