Alpha.Community

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

Функции

GetMonitor

int4 GetMonitor()

Возвращает номер монитора, на котором отображается большая часть окна. Если окно не отображается ни на одном из имеющихся мониторов, то функция возвращает значение -1.

Можно использовать совместно с функцией FitToMonitor(), чтобы расположить окно целиком на том мониторе, где открывается его большая часть.

GetMonitorForRect

int4 GetMonitorForRect(double left, double top, double width, double height)

Возвращает номер монитора, на котором отображается большая часть родительского компонента. Может использоваться для открытия формы в центре определенного прямоугольника.

Входные параметры:

  • X-координата левого верхнего угла родительского компонента;
  • Y-координата левого верхнего угла родительского компонента;
  • ширина родительского компонента;
  • высота родительского компонента.

CorrectPosition

void CorrectPosition()

Корректирует положение окна так, чтобы оно отобразилось на первом мониторе, если:

  • окно не отображается ни на одном из имеющихся мониторов;
  • окно невозможно переместить из-за выхода заголовка окна за пределы монитора.

Применяется при открытии окна с определенными координатами, которые могут выходить за область текущего монитора.

CorrectPositionAboutPoint

void CorrectPositionAboutPoint(int4 x, int4 y, int4 pointHeight)

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

Входные параметры:

  • X-координата точки;
  • Y-координата точки;
  • смещение вверх относительно низа монитора.

FitFormSize

void FitFormSize(double windowWidth, double windowHeight)

Подстраивает размер формы под размер окна, в котором она открывается, с учетом масштаба формы.

Входные параметры – ширина и высота окна.

FitToMonitor

void FitToMonitor(int4 monitor)

Размещает окно на указанном мониторе. Входной параметр – номер монитора, который можно получить с помощью функции GetMonitor().

FitToRect

void FitToRect(double left, double top, double width, double height)

Размещает форму в центре заданного прямоугольника.

Входные параметры:

  • X-координата левого верхнего угла родительского компонента;
  • Y-координата левого верхнего угла родительского компонента;
  • ширина родительского компонента;
  • высота родительского компонента.

Для того чтобы вызвать функцию в обработчике события AboutToOpen какой-либо формы, в свойстве формы Положение окна укажите значение Вручную.

GetViewSettings

string GetViewSettings()

Возвращает JSON-строку с описанием текущих положения, размеров и состояния окна.

Пример возвращаемого значения:

{
 "X":574,
 "Y":72,
 "Width":1017,
 "Height":749,
 "State":0
}

UpdateView

void UpdateView(string settings)

Применяет к окну настройки положения, размеров и состояния.

Входной параметр – настройки, указанные в виде JSON-строки.

Переопределение положения окна, указанного в свойстве Ссылка на форму экземпляра WindowUtils, с помощью функции UpdateView() этого экземпляра:

var window = JSON.parse(WindowUtils.GetViewSettings()); // получение текущих настроек окна
window.X = 100; // изменение координаты X
window.Y = 100; // изменение координаты Y
WindowUtils.UpdateView(JSON.stringify(window)); // применение новых настроек окна