Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Печать графических элементов

Для печати графических элементов в проектах Alpha.HMI используются следующие компоненты:

  • Компонент Печать позволяет отправлять на печать выбранные графические элементы.
  • Компонент Системные принтеры обеспечивает доступ к детальной информации о всех принтерах подключенных к системе. Компонент предоставляет такие данные, как названия принтеров, их описания, поддерживаемые разрешения печати и другие параметры.
  • Компонент Принтер предназначен для настройки параметров печати на конкретном принтере. Вы можете настроить такие параметры, как режим цветности печати, количество копий, ориентацию страниц и другие опции. Используйте этот компонент в сочетании с компонентом Печать для отправки на печать.
  • Компонент Размеры страницы предоставляет возможность настройки размеров печатной страницы. Используйте этот компонент для задания стандартных размеров страницы (например, A4, Letter) или создания пользовательских размеров с произвольными параметрами ширины, высоты и единиц измерения.

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

Как напечатать графический элемент

Далее кратко описан небольшой пример использования компонентов печати в проекте Alpha.HMI с использованием языка Alpha.Om.

В примере показано, как:

  • Получить список всех принтеров и определить название принтера, установленного по умолчанию;
  • Настроить параметры печати с помощью компонента Принтер;
  • Задать пользовательский размер печатной страницы с помощью компонента Размеры страницы;

  • Отправить на печать графический элемент через компонент Печать.

Получить список всех принтеров и определить название принтера, установленного по умолчанию

  1. Разместите на форме компонент Системные принтеры, который будет использован для доступа к информации о принтерах.

  2. Добавьте текстовое поле, которое будет отображать список всех принтеров и имя принтера, используемое по умолчанию.

  3. Поместите кнопку на форме, нажатие на которую инициирует запрос на получение списка принтеров и определение принтера по умолчанию.

  4. Настройте обработчик события ButtonPressed для кнопки, чтобы при её нажатии активировался процесс получения и отображения информации о принтерах. Пример кода:

    // Устанавливаем текст в текстовом поле: список всех принтеров и принтер по умолчанию
    Text_1.Text = PrinterInfoCollection_1.PrinterNames + "\nПо умолчанию: "
    + PrinterInfoCollection_1.PrinterDefaultName;

  5. Запустите форму в режиме рантайм, и после нажатия на кнопку Button_1 в текстовое поле будет выведен список доступных принтеров и название принтера, установленного в системе по умолчанию.

Настроить параметры печати

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

  2. В свойстве Имя принтера компонента Принтер установите принтер, определенный в предыдущем разделе как используемый по умолчанию, или выберите другой из списка.

  3. Настройте другие параметры печати, такие как Цветовой режим, Количество копий, Ориентация страницы и Качество печати , используя соответствующие свойства.

Задать пользовательский размер печатной страницы

  1. Разместите на форме компонент Размеры страницы.

  2. Установите свойство Размер в значение Особый и задайте следующие параметры:

  3. Укажите ссылку на добавленный ранее компонент Размеры страницы через свойство Размеры страницы для компонента Принтер. Для этого нажмите правой кнопкой мыши по свойству Размеры страницы → выберите Сослаться → выберите PageSize_1.

Отправить на печать графический элемент

  1. Добавьте на форму графический элемент, который вы хотите напечатать.

  2. Добавьте компонент Печать в качестве дочернего к графическому элементу.

  3. Укажите ссылку на добавленный ранее компонент Принтер для компонента Печать через свойство Принтер. Для этого нажмите правой кнопкой мыши по свойству Принтер→ Сослаться → Printer_1.

  4. Настройте в компоненте Печать свойство Область печати, выбирая, что именно будет напечатано. Для печати самого графического элемента выберите Родительский элемент.

  5. Разместите кнопку на форме, при нажатии на которую будет запускаться процесс печати.

  6. Настройте обработчик события ButtonPressed для кнопки, чтобы при её нажатии запускался процесс печати. Пример кода:

    Rectangle_1.Print_1.Print(); // Команда для запуска печати графического элемента
  7. Запустите форму в режиме рантайм, и после нажатия на кнопку Button_2 будет активирован процесс печати графического элемента с использованием заданного размера печатной страницы (200 × 300 мм).