Просмотр кода страницы Описание классов для рисования и работы с графическим интерфейсом AgavaSCADA/AgavaPLC

== Обзор ==
Данное описание предназначено для использования с системами версии 1.6+. Ниже описываются инструменты, реализующие вывод графических примитивов, инструменты рисования и обработки событий.

== Основные классы и структуры ==

=== Rect ===
Прямоугольная область с координатами и размерами.

'''Конструкторы:'''

* <code>Rect()</code> - пустой прямоугольник
* <code>Rect(int x, int y, int w, int h)</code> - с заданными параметрами

'''Свойства:'''

* <code>int x</code>, <code>int y</code> - координаты верхнего левого угла
* <code>int width</code>, <code>int height</code> - размеры

'''Пример использования:'''
 Rect rect(10, 20, 100, 50);  // x=10, y=20, width=100, height=50
 Rect area = Rect(0, 0, 800, 600);

=== Point ===
Точка в 2D-пространстве.

'''Конструкторы:'''

* <code>Point()</code> - точка (0,0)
* <code>Point(int x, int y)</code> - с заданными координатами

'''Свойства:'''

* <code>int x</code>, <code>int y</code> - координаты

'''Пример использования:'''
 Point start(0, 0);
 Point end(100, 100);
 Point center = Point(50, 50);

=== Color ===
Цвет в формате RGBA.

'''Конструкторы:'''

* <code>Color()</code> - черный непрозрачный
* <code>Color(int r, int g, int b, int a = 255)</code> - с компонентами цвета

'''Свойства:'''

* <code>int r</code>, <code>int g</code>, <code>int b</code> - цветовые компоненты (0-255)
* <code>int a</code> - альфа-канал (0-255), где 255 - полностью непрозрачный

'''Пример использования:'''
 Color red(255, 0, 0);        // Красный
 Color blue(0, 0, 255, 128);  // Синий полупрозрачный
 Color white(255, 255, 255);  // Белый

=== Font ===
Описание шрифта для текста.

'''Конструкторы:'''

* <code>Font()</code> - шрифт по умолчанию
* <code>Font(int size, string name, bool italic = false, bool bold = false, bool underline = false, bool strikethrough = false)</code>

'''Свойства:'''

* <code>int size</code> - размер шрифта
* <code>string name</code> - название шрифта
* <code>bool italic</code> - курсив
* <code>bool bold</code> - жирный
* <code>bool underline</code> - подчеркнутый
* <code>bool strikethrough</code> - зачеркнутый

'''Пример использования:'''
 Font defaultFont;
 Font titleFont(24, "Arial", false, true);           // Жирный Arial 24px
 Font italicFont(12, "Times New Roman", true);       // Курсивный

=== Pen ===
Инструмент для рисования линий и контуров.

'''Конструкторы:'''

* <code>Pen()</code> - перо по умолчанию
* <code>Pen(int size, Color color, LineType lineType = LineType::Solid)</code>

'''Свойства:'''

* <code>int size</code> - толщина линии
* <code>Color color</code> - цвет
* <code>LineType lineType</code> - тип линии

'''Перечисление LineType:'''

* <code>Undefined</code> - неопределенный тип
* <code>Solid</code> - сплошная линия
* <code>Dash</code> - пунктирная линия
* <code>Dot</code> - точечная линия
* <code>DashDot</code> - штрих-пунктирная
* <code>DashDotDot</code> - штрих-две точки

'''Пример использования:'''
 Pen thinRed(1, Color(255, 0, 0), LineType::Solid);
 Pen thickBlue(3, Color(0, 0, 255), LineType::Dash);
 Pen dottedBlack(2, Color(0, 0, 0), LineType::Dot);

=== ResourceLink ===
Ссылка на ресурсы (изображения, звуковый файлы).

'''Конструкторы:'''

* <code>ResourceLink()</code> - пустая ссылка
* <code>ResourceLink(const string &in path)</code> - из файлового пути
* <code>ResourceLink(const string &in lib, const string &in res)</code> - из библиотеки ресурсов

'''Методы:'''

* <code>string GetFilePath() const</code> - путь к файлу
* <code>string GetFullFilePath() const</code> - полный путь
* <code>string GetLibraryName() const</code> - имя библиотеки
* <code>string GetResourceName() const</code> - имя ресурса
* <code>bool IsValid()</code> - проверка валидности
* <code>bool IsEmpty()</code> - проверка на пустоту
* <code>LinkType GetLinkType() const</code> - тип ссылки
* <code>string ToString()</code> - строковое представление

'''Перечисление LinkType:'''

* <code>Undefined</code> - неопределенный тип
* <code>Resource</code> - ресурс из библиотеки
* <code>File</code> - файл из файловой системы

'''Пример использования:'''
 ResourceLink fileImage("images/background.png");
 ResourceLink libImage("textures", "wood_pattern");
 ResourceLink invalidLink;
 
 if (fileImage.IsValid()) 
 {
     string path = fileImage.GetFilePath();
 }

=== Gradient ===
Градиентная заливка.

'''Конструкторы:'''

* <code>Gradient()</code> - градиент по умолчанию
* <code>Gradient(GradientType type)</code> - с указанием типа

'''Свойства:'''

* <code>GradientType type</code> - тип градиента
* <code>Point start</code>, <code>Point end</code> - начальная и конечная точки (для линейного)
* <code>Point center</code> - центр (для радиального)
* <code>float radius</code> - радиус (для радиального)
* <code>Point focal</code> - фокальная точка
* <code>Point centerConical</code> - центр конического градиента
* <code>float angle</code> - угол

'''Методы для работы с цветовыми остановками:'''

* <code>void AddColorStop(float position, Color color)</code> - добавить цветовую остановку
* <code>void ClearColorStops()</code> - очистить все остановки
* <code>int GetColorStopCount() const</code> - количество остановок
* <code>void GetColorStop(int index, float& out position, Color& out color) const</code> - получить остановку
* <code>void SetColorStop(int index, float position, Color color)</code> - установить остановку

'''Перечисление GradientType:'''

* <code>Linear</code> - линейный градиент
* <code>Radial</code> - радиальный градиент
* <code>Conical</code> - конический градиент

'''Пример использования:'''
 Gradient linearGrad(GradientType::Linear);
 linearGrad.start = Point(0, 0);
 linearGrad.end = Point(100, 0);
 linearGrad.AddColorStop(0.0, Color(255, 0, 0));    // Красный в начале
 linearGrad.AddColorStop(1.0, Color(0, 0, 255));    // Синий в конце
 
 Gradient radialGrad(GradientType::Radial);
 radialGrad.center = Point(50, 50);
 radialGrad.radius = 50;

=== Brush ===
Инструмент заливки.

'''Конструкторы:'''

* <code>Brush()</code> - кисть по умолчанию
* <code>Brush(Color color, BrushStyle style = BrushStyle::SolidPattern)</code> - сплошной цвет
* <code>Brush(Gradient gradient, BrushStyle style = BrushStyle::LinearGradientPattern)</code> - градиент
* <code>Brush(ResourceLink texture, BrushStyle style = BrushStyle::TexturePattern)</code> - текстура

'''Свойства:'''

* <code>BrushStyle style</code> - стиль кисти
* <code>Color color</code> - цвет (для SolidPattern)
* <code>Gradient gradient</code> - градиент
* <code>ResourceLink texture</code> - текстура

'''Перечисление BrushStyle:'''

* '''Сплошные и пустые:''' <code>NoBrush</code>, <code>SolidPattern</code>
* '''Плотность заливки:''' <code>Dense1Pattern</code> - <code>Dense7Pattern</code> (от самой плотной до самой редкой)
* '''Линейные паттерны:''' <code>HorPattern</code> (горизонтальные линии), <code>VerPattern</code> (вертикальные линии), <code>CrossPattern</code> (сетка)
* '''Диагональные паттерны:''' <code>BDiagPattern</code>, <code>FDiagPattern</code>, <code>DiagCrossPattern</code>
* '''Специальные:''' <code>LinearGradientPattern</code>, <code>RadialGradientPattern</code>, <code>ConicalGradientPattern</code>, <code>TexturePattern</code>

'''Пример использования:'''
 Brush solidRed(Color(255, 0, 0));
 Brush gradientBrush(linearGrad);  // Градиентная кисть
 Brush textureBrush(textureLink, BrushStyle::TexturePattern);
 Brush patternBrush(Color(0, 0, 0), BrushStyle::CrossPattern);  // Сетка

=== Alignment ===
Флаги выравнивания текста.

'''Значения:'''

* '''Горизонтальное:''' <code>AlignLeft</code>, <code>AlignRight</code>, <code>AlignHCenter</code>, <code>AlignJustify</code>, <code>AlignAbsolute</code>
* '''Вертикальное:''' <code>AlignTop</code>, <code>AlignBottom</code>, <code>AlignVCenter</code>, <code>AlignBaseline</code>
* '''Комбинированные:''' <code>AlignCenter</code> (центр по горизонтали и вертикали)

'''Пример использования:'''
 Alignment leftTop = Alignment::AlignLeft | Alignment::AlignTop;
 Alignment center = Alignment::AlignCenter;
 Alignment rightBottom = Alignment::AlignRight | Alignment::AlignBottom;

== Класс Painter ==
Основной класс для рисования, предоставляющий широкий набор графических операций.

=== Методы рисования фигур ===
'''Дуги и секторы'''

* <code>DrawArc(const Rect &in, int startAngle, int spanAngle)</code> - дуга в прямоугольнике
* <code>DrawArc(int x, int y, int w, int h, int startAngle, int spanAngle)</code> - дуга с координатами
* <code>DrawChord()</code> - хорда (замкнутая дуга)
* <code>DrawPie()</code> - сектор круга

'''Пример:'''
 painter.DrawArc(Rect(10, 10, 100, 100), 45, 90);  // Дуга от 45 до 135 градусов
 painter.DrawPie(50, 50, 80, 80, 0, 90);          // Сектор 90 градусов
'''Эллипсы и окружности'''
* <code>DrawEllipse(const Rect &in)</code> - эллипс в прямоугольнике
* <code>DrawEllipse(int x, int y, int w, int h)</code> - эллипс с координатами
* <code>DrawEllipse(const Point &in center, int rx, int ry)</code> - эллипс из центра

'''Пример:'''
 painter.DrawEllipse(Rect(0, 0, 200, 100));      // Эллипс
 painter.DrawEllipse(Point(100, 100), 50, 50);   // Окружность
'''Линии и точки'''
* <code>DrawLine(int x1, int y1, int x2, int y2)</code> - линия между точками
* <code>DrawLine(const Point &in start, const Point &in end)</code> - линия между точками
* <code>DrawPoint(const Point &in)</code> - точка
* <code>DrawPoint(int x, int y)</code> - точка с координатами

'''Пример:'''
 painter.DrawLine(0, 0, 100, 100);                    // Диагональная линия
 painter.DrawLine(Point(10, 10), Point(50, 50));      // Линия между точками
 painter.DrawPoint(25, 25);                           // Точка
'''Прямоугольники'''

* <code>DrawRect(const Rect &in)</code> - прямоугольник
* <code>DrawRect(int x, int y, int w, int h)</code> - прямоугольник с координатами
* <code>DrawRoundedRect(const Rect &in, double xRadius, double yRadius)</code> - скругленный прямоугольник
* <code>DrawRoundedRect(int x, int y, int w, int h, double xRadius, double yRadius)</code> - скругленный с координатами

'''Пример:'''
 painter.DrawRect(Rect(10, 10, 100, 50));            // Прямоугольник
 painter.DrawRoundedRect(20, 20, 80, 40, 10, 10);   // Скругленный прямоугольник
'''Изображения'''

* <code>DrawImage(const Rect &in target, const ResourceLink &in image, const Rect &in source)</code> - изображение с областью
* <code>DrawImage(const Point &in pos, const ResourceLink &in image, const Rect &in source)</code> - изображение в позиции с областью
* <code>DrawImage(const Rect &in target, const ResourceLink &in image)</code> - изображение в прямоугольник
* <code>DrawImage(const Point &in pos, const ResourceLink &in image)</code> - изображение в позиции

'''Пример:'''
 ResourceLink img("images/icon.png");
 painter.DrawImage(Point(0, 0), img);                           // Рисуем в позиции (0,0)
 painter.DrawImage(Rect(10, 10, 32, 32), img);                 // Масштабируем в прямоугольник
 painter.DrawImage(Rect(0, 0, 64, 64), img, Rect(0, 0, 32, 32)); // Часть изображения
'''Текст'''

* <code>DrawText(const Point &in pos, const string &in text)</code> - текст в позиции
* <code>DrawText(int x, int y, const string &in text)</code> - текст с координатами
* <code>DrawText(const Rect &in rect, int alignment, const string &in text)</code> - текст в прямоугольнике с выравниванием
* <code>DrawText(int x, int y, int w, int h, int alignment, const string &in text)</code> - текст в области с выравниванием

'''Пример:'''
 painter.DrawText(Point(10, 10), "Hello World");                    // Простой текст
 painter.DrawText(Rect(0, 0, 200, 50), Alignment::AlignCenter, "Centered Text");  // Выровненный текст

=== Методы заливки и очистки ===

* <code>EraseRect(const Rect &in)</code> - очистить прямоугольную область
* <code>EraseRect(int x, int y, int w, int h)</code> - очистить область с координатами
* <code>FillRect(const Rect &in, const Brush &in)</code> - залить прямоугольник кистью
* <code>FillRect(int x, int y, int w, int h, const Brush &in)</code> - залить область кистью
* <code>FillRect(const Rect &in, const Color &in)</code> - залить прямоугольник цветом
* <code>FillRect(int x, int y, int w, int h, const Color &in)</code> - залить область цветом

'''Пример:'''
 painter.FillRect(Rect(0, 0, 100, 100), Color(255, 0, 0));      // Красный прямоугольник
 painter.FillRect(10, 10, 50, 50, gradientBrush);              // Градиентная заливка
 painter.EraseRect(5, 5, 10, 10);                              // Очистить область

=== Управление состоянием ===
'''Геттеры и сеттеры стилей'''

* <code>Brush GetBackground()</code>, <code>void SetBackground(const Brush &in)</code> - фон
* <code>Brush GetBrush()</code>, <code>void SetBrush(const Brush &in)</code> - кисть заливки
* <code>Point GetBrushOrigin()</code>, <code>void SetBrushOrigin(const Point &in)</code> - начало координат кисти
* <code>Font GetFont()</code>, <code>void SetFont(const Font &in)</code> - шрифт текста
* <code>Pen GetPen()</code>, <code>void SetPen(const Pen &in)</code> - перо для линий

'''Пример:'''
 // Установка стилей
 painter.SetPen(Pen(2, Color(0, 0, 0)));
 painter.SetBrush(Brush(Color(255, 255, 0)));
 painter.SetFont(Font(12, "Arial", false, true));
 
 // Получение текущих стилей
 Pen currentPen = painter.GetPen();
 Brush currentBrush = painter.GetBrush();

=== Трансформации и clipping ===
'''Трансформации'''

* <code>void ResetTransform()</code> - сброс всех трансформаций
* <code>void Rotate(double angle)</code> - поворот на угол (в градусах)
* <code>void Scale(double sx, double sy)</code> - масштабирование
* <code>void Shear(double sh, double sv)</code> - наклон/скос
* <code>void Translate(const Point &in)</code> - смещение
* <code>void Save()</code>, <code>void Restore()</code> - сохранение/восстановление состояния

'''Clipping (область отсечения)'''

* <code>bool HasClipping()</code> - проверка наличия области отсечения
* <code>void SetClipRect(const Rect &in, int operation = 1)</code> - установка прямоугольной области отсечения
* <code>void SetClipRect(int x, int y, int w, int h, int operation = 1)</code> - установка области с координатами
* <code>void SetClipping(bool enable)</code> - включить/выключить отсечение

'''Пример:'''
 // Трансформации
 painter.Save();                          // Сохраняем состояние
 painter.Translate(Point(100, 100));      // Смещаем начало координат
 painter.Rotate(45);                      // Поворачиваем на 45 градусов
 painter.Scale(1.5, 1.0);                 // Масштабируем
 // Рисуем трансформированные объекты
 painter.Restore();                       // Восстанавливаем состояние
 
 // Clipping
 painter.SetClipRect(Rect(50, 50, 100, 100));  // Устанавливаем область отсечения
 // Все рисование будет обрезано по этой области

=== Вспомогательные методы ===

* <code>bool HasClipping()</code> - проверка наличия clipping
* <code>int GetLayoutDirection()</code>, <code>void SetLayoutDirection(int)</code> - направление layout (LTR/RTL)
* <code>double GetOpacity()</code>, <code>void SetOpacity(double)</code> - прозрачность (0.0-1.0)
* <code>Rect GetBoundingRect(const Rect &in, int alignment, const string &in text)</code> - вычисление ограничивающего прямоугольника для текста
* <code>Rect GetBoundingRect(int x, int y, int w, int h, int alignment, const string &in text)</code> - вычисление с координатами

'''Пример:'''
 // Вычисление размера текста
 Rect textBounds = painter.GetBoundingRect(Rect(0, 0, 0, 0), Alignment::AlignLeft, "Sample Text");
 int textWidth = textBounds.width;
 int textHeight = textBounds.height;
 
 // Установка прозрачности
 painter.SetOpacity(0.5);  // Полупрозрачное рисование

=== Полный пример использования Painter ===
 // Создание инструментов
 Pen borderPen(2, Color(0, 0, 0), LineType::Solid);
 Brush fillBrush(Color(255, 255, 0));
 Font textFont(14, "Arial", false, true);
 
 // Настройка painter
 painter.SetPen(borderPen);
 painter.SetBrush(fillBrush);
 painter.SetFont(textFont);
 
 // Рисование
 painter.DrawRect(Rect(10, 10, 100, 50));                    // Прямоугольник
 painter.DrawEllipse(Point(150, 35), 25, 15);               // Эллипс
 painter.DrawLine(Point(200, 10), Point(250, 60));          // Линия
 painter.DrawText(Point(15, 15), "Hello World");            // Текст
 
 // Градиентная заливка
 Gradient grad(GradientType::Linear);
 grad.start = Point(0, 0);
 grad.end = Point(100, 0);
 grad.AddColorStop(0.0, Color(255, 0, 0));
 grad.AddColorStop(1.0, Color(0, 0, 255));
 Brush gradBrush(grad);
 painter.SetBrush(gradBrush);
 painter.FillRect(Rect(300, 10, 100, 50), gradBrush);

== Обработка событий ==

=== MouseEvent ===
Событие мыши.

'''Методы:'''

* <code>MouseButton button() const</code> - нажатая кнопка
* <code>Point pos() const</code> - позиция курсора
* <code>int x() const</code> - координата X
* <code>int y() const</code> - координата Y

'''Перечисление MouseButton:'''

* <code>NoButton</code> - нет нажатой кнопки
* <code>LeftButton</code> - левая кнопка мыши
* <code>RightButton</code> - правая кнопка мыши
* <code>MiddleButton</code> - средняя кнопка мыши

'''Пример использования:'''
 void OnMouseClick(MouseEvent@ event) 
 {
     if (event.button() == MouseButton::LeftButton) 
     {
         Point clickPos = event.pos();
         int x = event.x();
         int y = event.y();
     }
 }

=== WheelEvent ===
Событие колесика мыши.

'''Методы:'''

* <code>int angleDelta() const</code> - угол поворота колесика (положительный - вверх, отрицательный - вниз)

'''Пример использования:'''
 void OnWheel(WheelEvent@ event) 
 {
     int delta = event.angleDelta();
     
     if (delta > 0) 
     {
         // Прокрутка вверх
     } 
     else 
     {
         // Прокрутка вниз
     }
 }
 
[[Категория:AgavaSCADA/AgavaPLC]]