Variable

Объект; не имеет графического отображения.

Шаблон Variable

Перечень всех возможных тэгов объекта:

<MyObject Name="" Type="Variable" Assembly="SimpleControls" ChangeForm="">
  <!--Тэги, общие для всех графических объектов-->
  <Change User="" Source="" ValueSet="" />
  <!--Тэги, специфичные для Variable-->
  <SaveOnFormClose Value=""/>
  <Value></Value>
</MyObject>

Описание Variable

<MyObject Name="" Type="Variable" Assembly="SimpleControls" ChangeForm="True">
  <!--Тэги, общие для всех графических объектов-->
  <!--Тэги, специфичные для Variable-->
</MyObject>

Значением Variable считается значение, указанное в тэге <Value>.

Получение значения

Для получения значения объекта используется get-проперти Value:

<Object Name="VariableName">
  <Property Name="Value" />
</Object>

Рекомендуется использовать сокращенный вариант записи:

<Object Name="VariableName" />

Задание значения

Для задания значения объекту используется set-проперти Value:

<Object Name="VariableName">
  <Property Name="Value">Новое значение</Property>
</Object>

Рекомендуется использовать сокращенный вариант записи:

<Object Name="VariableName">Новое значение</Object>

Тэги, специфичные для Variable

Value

Значение объекта Variable.

Необязательный тэг. Ожидается любое значение.

По умолчанию используется значение NULL.

<Value>Value</Value>

SaveOnFormClose

Настройка сохранения значения переменной в базе данных в таблице public.user_form_info.

Необязательный тэг. В качестве значения атрибута Value ожидается логическое значение.

По умолчанию используется значение False.

<SaveOnFormClose Value="True"/>

Get-проперти для получения свойств

Value

Возвращает значение объекта Variable, если он его имеет.

<Object Name="VariableName">
  <Property Name="Value" />
</Object>

ValueChanged

Возвращает признак того, было ли изменено значение объекта Variable в процессе работы.

<Object Name="VariableName">
  <Property Name="ValueChanged" />
</Object>

Есть 3 способа изменить значение объекта:

1. Изменить значение прямым образом в графическом интерфейсе формы, с помощью set-проперти ValueChanged.
2. Указать источник значения (ссылка на любые данные на форме). В случае изменения значения в источнике, автоматически изменится значение и самого объекта.

3. Присвоить значение объекту посредством команды ValueSetCommand.

Set-проперти для динамического задания свойств

Value

Задает значение объекта Variable.

Ожидается любое значение.

<Object Name="VariableName">
  <Property Name="Value">Value</Property>
</Object>

ValueChanged

Задает признак изменения значения объекта Variable.

Ожидается логическое значение.

<Object Name="VariableName">
  <Property Name="ValueChanged">False</Property>
</Object>

Refresh

Обновляет значение объекта Variable.

<Object Name="ConstVariable">
  <Property Name="Refresh" />
</Object>

Примеры

Работают только со числами. Со строками не работают вообще.

Пример 1. Работающий.

<MyObject Name="Variable" Type="Variable" Assembly="SimpleControls">
  <Value>
	<Calculate>
	  <Expression>if({0}={1}, 1, 2)</Expression>
	  <Items>
		<Item>1</Item>
		<Item>0</Item>
	  </Items>
	</Calculate>
  </Value>
</MyObject>

Пример 2. Не работающий.

<MyObject Name="Variable" Type="Variable" Assembly="SimpleControls">
  <Value>
	<Calculate>
	  <Expression>if({0}='test', 1, 2)</Expression>
	  <Items>
		<Item>test</Item>
		<Item>0</Item>
	  </Items>
	</Calculate>
  </Value>
</MyObject>