Работа с таблицами в MultiCAD.NET. Часть 3. Внешние файлы таблиц и обмен данными с Microsoft Excel

В предыдущих статьях о таблицах в MultiCAD.NET речь шла о программном создании и форматировании таблиц в чертеже, использовании различных типов данных в качестве содержимого, а также о применении шаблонов таблиц. В этой статье мы продолжим рассказ об использовании шаблонов и более подробно рассмотрим API, позволяющий сохранить таблицу во внешний файл в качестве шаблона и загрузить его в чертеж для формирования типовых таблиц. Во второй половине статьи будет рассмотрен процесс обмена данными с Microsoft Excel.

Исходная таблица

Пусть исходная таблица содержит характеристики металлического профиля — наименование, марка, толщина стали, назначение — структура которой может быть использована для описания различных типов профиля: направляющего, стоечного и пр.:

Мы не будем останавливаться на процедуре создания такой таблицы: о том, как создавать и редактировать таблицы мы писали ранее, в предыдущей статье.

Сохранение таблицы как шаблон

Для сохранения таблицы в отдельный файл используется метод McTable.SaveToFile(). Метод позволяет записывать таблицу в файлы следующих форматов:

• файлы таблиц (.dat),


• текст, разделенный табуляцией (.txt),


• текст, разделенный точкой с запятой (.csv),


• XML,


• книга Microsoft Excel (.xls),


• таблицы OpenOffice.org (.ods).

Таблицу, которую нужно сохранить в качестве шаблона, можно выбрать на чертеже. Следующая команда сохраняет выбранную таблицу в один из доступных форматов:

[CommandMethod("smpl_SaveTable", CommandFlags.NoCheck | CommandFlags.NoPrefix)]
public void smpl_SaveTable()
{
  McObjectId idSelected = McObjectManager.SelectObject("Укажите таблицу для записи:");
  if (idSelected.IsNull)
  {
    return;
  }
  McTable outObj = McObjectManager.GetObject(idSelected);
  if (outObj == null)
  {
    return;
  }
  // Без указания параметров метод SaveToFile() вызовет диалог, 
  // в котором пользователю будет предложено выбрать имя и формат файла.
  outObj.SaveToFile();
}

Загрузка таблицы из файла

Загрузка таблицы из внешнего файла производится с помощью метода McTable.LoadFromFile(). Как и для SaveToFile(), имя файла может быть указано явно или выбрано из диалога. Поддерживаются следующие форматы загружаемых файлов:

• Файлы таблиц (.tbl, .dat),


• текстовые форматы (.txt, .csv, .xml),


• файлы Microsoft Access(.mdb, .accdb),


• книга Microsoft Excel (.xls, .xlsx),


• таблицы OpenOffice.org (.ods),


• таблицы StarOffice (.sxc).

Следующая команда добавляет в чертеж таблицу из файла, выбранного пользователем:

[CommandMethod("smpl_LoadTable", CommandFlags.NoCheck | CommandFlags.NoPrefix)]
public void smpl_LoadTable()
{
  McTable Table2 = new McTable();
  // Без указания параметров метод LoadFromFile() вызовет диалог, 
  // в котором пользователю будет предложено выбрать имя и формат файла.
  if (Table2.LoadFromFile())
  {
    Table2.PlaceObject(McEntity.PlaceFlags.Silent);
  }
}

Теперь мы можем использовать сохраненную таблицу в качестве шаблона для добавления в чертеж типовых таблиц:

Обмен данными с Microsoft Excel

Кроме сохранения таблиц в файлы различного формата, MultiCAD.NET содержит возможность быстрого переноса табличных данных в лист Microsoft Excel и обратно.

При вызове метода ExportToExcel() открывается новая книга Excel и в неё переносятся все табличные данные с сохранением форматирования ячеек, установленного в таблице.

Добавим команду, которая позволит выбрать на чертеже таблицу, и экспортировать ее в лист Excel:

[CommandMethod("smpl_ExportTableToExcel", CommandFlags.NoCheck | CommandFlags.NoPrefix)]
public void smpl_ExportTableToExcel()
{
  McObjectId idSelected = McObjectManager.SelectObject("Укажите таблицу для экспорта:");
  if (idSelected.IsNull)
  {
    return;
  }
  McTable outObj = McObjectManager.GetObject(idSelected);
  if (outObj == null)
  {
    return;
  }
  outObj.ExportToExcel();
}

MultiCAD.NET также поддерживает импорт выделенного диапазона ячеек таблицы из открытого листа Excel, для чего нужно вызвать функцию ImportFromExcel().

Следующая команда вставляет выделенный диапазон ячеек из листа Excel в чертеж:

[CommandMethod("smpl_ImportTableFromExcel", CommandFlags.NoCheck | CommandFlags.NoPrefix)]
    public void smpl_ImportTableFromExcel()
    {
      McTable Table2 = new McTable();
      if (Table2.ImportFromExcel())
      {
        Table2.PlaceObject(McEntity.PlaceFlags.Silent);
      }
    }

Этой публикацией мы завершаем обзор основных средств для работы с таблицами в MultiCAD.NET API. Конечно же, это далеко не все возможности, которые предоставляет табличный функционал, тем более, что в настоящее время работы по его расширению и улучшению продолжаются.

Если те или иные аспекты работы с таблицами остались недостаточно подробно освещенными, пишите комментарии, предлагайте темы для будущих статей.

This entry passed through the Full-Text RSS service — if this is your content and you're reading it on someone else's site, please read the FAQ at fivefilters.org/content-only/faq.php#publishers.