Документ Excel

Документ Excel — компонент, используется для подключения Excel-документа к проекту, на выходе передает указатель на Excel-файл со специального контакта.

Внешний вид компонента

Режим проектировщика Режим оператора
Документ Excel - Режим проектировщика Не имеет

Параметры:

Входные

  • Вкл\Выкл — подключается/отключается к заданному Excel-файлу.
  • Название — название документа, к которому подключаться.
  • Вкл\Выкл — включается либо отключается отображение редактируемого Excel-файла.
  • Сохранить — при поступлении управляющего импульса на данный контакт, сохраняет подключенный документ.

Выходные

  • Книга — поступает указатель на Excel-файл.

Настраиваемые свойства:

Общие свойства (окружение)

Частные свойства (в скобках значение, установленное по умолчанию):

  • ExcelDocFileName — название документа, к которому подключаемся, если не указано, создается чистый документ.
  • ExcelDocVisible (false) — параметр, устанавливающий видимость редактируемого excel-файла. Принимает значения true/false. Если значение параметра = true, ZETView обратится к MSExcel и откроет указанный файл.
  • Password_read — строка, содержащая пароль на открытие указанного Excel-файла.
  • Password_write — строка, содержащая пароль на запись данных в указанный Excel-файл.

Параметры:

Для записи данных в Excel-файл, используется совместно с компонентами «Страница Excel» и «Ячейка Excel«. Соединять компоненты нужно в следующей последовательности:

dokument-excel-opisanie

Данный компонент скорее является составным блоком, нежели самостоятельным компонентом. Необходим при работе с 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

Документ Excel - Пример

Данный компонент используется для создания различных проектов, в том числе таких как тензометрическая система.

Результат работы проекта
Документ Excel - Результат работы проекта