Alpha.Community

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

Функции

FormX и FormY

Вычисляют координаты заданной точки объекта относительно экранной формы. Точка задаётся в локальной системе координат объекта: начало (0, 0) находится в точке, заданной свойствами X и Y объекта, ось X направлена вправо, ось Y — вниз. Координаты измеряются в пикселях.

Синтаксис

FormX(double X, double Y)
FormY(double X, double Y)

Параметры

X double Координата точки по оси X в локальной системе координат объекта.
Y double Координата точки по оси Y в локальной системе координат объекта.

Примеры

Записать в поля ввода координаты начальной точки объекта (X, Y) относительно экранной формы:

TextEdit1.Text = Object.FormX(0, 0);
TextEdit2.Text = Object.FormY(0, 0);

Найти координаты точки внутри вложенного объекта относительно экранной формы. На форме расположен прямоугольник (Rectangle_1) с координатами (604, 803), внутри него — кнопка (Button_1) с координатами (52, 40) относительно прямоугольника.
В локальной системе координат кнопки задана точка (10, 15):

fX = Rectangle_1.Button_1.FormX(10, 15);   // 604 + 52 + 10 = 666
fY = Rectangle_1.Button_1.FormY(10, 15); // 803 + 40 + 15 = 858

ScreenX и ScreenY

Вычисляют координаты заданной точки объекта относительно экрана монитора. Точка задаётся в локальной системе координат объекта: начало (0, 0) находится в точке, заданной свойствами X и Y объекта, ось X направлена вправо, ось Y — вниз. Координаты измеряются в пикселях.

Синтаксис

ScreenX(double X, double Y)
ScreenY(double X, double Y)

Параметры

X double Координата точки по оси X в локальной системе координат объекта.
Y double Координата точки по оси Y в локальной системе координат объекта.

Примеры

Записать в поля ввода координаты начальной точки объекта относительно экрана монитора:

TextEdit1.Text = Object.ScreenX(0, 0);
TextEdit2.Text = Object.ScreenY(0, 0);

Найти координаты точки внутри вложенного объекта относительно экрана монитора. Форма расположена на экране с координатами (200, 150). На форме расположен прямоугольник Rectangle_1 с координатами (604, 803), внутри него — кнопка Button_1 с координатами (52, 40) относительно прямоугольника.
В локальной системе координат кнопки задана точка (10, 15):

fX = Rectangle_1.Button_1.ScreenX(10, 15);   // 200 + 604 + 52 + 10 = 866
fY = Rectangle_1.Button_1.ScreenY(10, 15); // 150 + 803 + 40 + 15 = 1008

Close

Закрывает текущую экранную форму.

Синтаксис

void Close()

Примеры

Закрыть форму, если флажок установлен. В противном случае вывести сообщение.

if (Checkbox.State)
  here.Close();
else
  TextEdit.Text = "Чтобы закрыть форму, установите флажок";

Hide

Скрывает текущую экранную форму, не закрывая её.

Синтаксис

void Hide()

Примеры

Скрыть форму, если флажок установлен. В противном случае вывести сообщение.

if (Checkbox.State)
here.Hide();
else
TextEdit.Text = "Чтобы скрыть форму, установите флажок";

Show

Отображает скрытую экранную форму.

Синтаксис

void Show()

Примеры

Отобразить скрытую форму Form_1.

ref_Form_1.Show(); // Используем ссылку на Form_1 для отображения её из другой формы

Raise

Перемещает окно формы на передний план.

Синтаксис

void Raise()

Примеры

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

if (Checkbox.State)
here.Raise();
else
TextEdit.Text = "Чтобы поднять форму на передний план, установите флажок";

Activate

Делает окно формы активным (переводит фокус на форму).

Синтаксис

void Activate()

Примеры

Сделать форму активной, если флажок установлен. В противном случае вывести сообщение.

if (Checkbox.State)
here.Activate();
else
TextEdit.Text = "Чтобы активировать форму, установите флажок";

Print

Печатает текущую форму.

Этот метод устарел. Для печати используйте метод Print компонента Печать.

Синтаксис

void Print()

Примеры

Напечатать текущую форму.

here.Print();

SaveScreenShot

Создаёт скриншот текущей формы и сохраняет его в указанном графическом формате по заданному пути. Поддерживаемые форматы: *.png, *.jpg, *.bmp и другие растровые форматы.

Синтаксис

void SaveScreenShot(string path)

Параметры

path string Путь и имя файла для сохранения скриншота.

Примеры

Сохранить скриншот формы в формате *.jpeg.

here.SaveScreenShot("C:/WORK/TU_UK/KP_635.jpeg");

PrintDialog

Открывает диалоговое окно для предпросмотра печати.

Этот метод устарел. Для предпросмотра печати используйте метод PrintPreviewDialog компонента Печать.

Синтаксис

void PrintDialog()

Примеры

Открыть диалоговое окно предпросмотра печати.

here.PrintDialog();

SavePdf

Сохраняет текущую форму в формате PDF по указанному пути.

Синтаксис

void SavePdf(string path)

Параметры

path string Путь и имя файла для сохранения PDF-документа.

Примеры

Сохранить форму в PDF по заданному пути.

here.SavePdf("C:/Reports/FormReport.pdf");

DoAutoSize

Автоматически изменяет размер окна так, чтобы оно соответствовало размерам экранной формы.

Синтаксис

void DoAutoSize()

Примеры

Подогнать размер окна под размеры экранной формы.

here.DoAutoSize();

SetBoundingRegion

Задаёт область, за пределы которой окно экранной формы не может быть перемещено. Это позволяет ограничить перемещение окна определённой зоной.

Синтаксис

void SetBoundingRegion(int4 x, int4 y, uint4 width, uint4 height)

Параметры

x int4 Координата X верхнего левого угла области ограничения.
y int4 Координата Y верхнего левого угла области ограничения.
width uint4 Ширина области ограничения. Измеряется в пикселях и отсчитывается от точки начала области.
height uint4 Высота области ограничения. Измеряется в пикселях и отсчитывается от точки начала области.

Примеры

Ограничить перемещение окна областью размером 400x400 пикселей с началом в точке 500, 200.

here.SetBoundingRegion(500, 200, 400, 400);

ResetBoundingRegion

Снимает все ограничения перемещения окна экранной формы, установленные ранее с помощью метода SetBoundingRegion.

Синтаксис

void ResetBoundingRegion()

Примеры

Отменить ограничения на перемещение окна.

here.ResetBoundingRegion();