FormShowCommand

Команда; открывает дочернюю форму.

Шаблон FormShowCommand

<Command Name="" Type="FormShowCommand" Assembly="Commands">
  <!--Тэги, общие для всех команд-->
  <Condition Name="" />
  <Lock Value="" />
  <!--Тэги, специфичные для FormShowCommand-->
  <Xml Type="Path"></Xml>
  <Show Type="" WithoutFocus="" />
  <Multiple Allow="" Reload="" />
  <Parameters>
    <Parameter Name="" />
  </Parameters>
  <UpdateResult Type="" />
  <Owner Form="" />
</Command>

Описание FormShowCommand

<Command Name="FormShowCommandName" Type="FormShowCommand" Assembly="Commands">
  <!--Тэги, общие для всех команд-->
  <!--Тэги, специфичные для FormShowCommand-->
</Command>

Результатом выполнения команды FormShowCommand будут:

• Список неявных параметров открывающейся формы.

• Список явных параметров открывающейся формы.

• FormClosed - событийный параметр, срабатывает сразу же после закрытия формы.

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

Xml

Xml-код дочерней формы.

Обязательный тэг. Значение тэга <Xml>: зависит от значений атрибутов.

<Xml Type="Path">Path</Xml>

Атрибуты тэга <Xml>

Type	Название типа загрузки xml-код. Обязательный атрибут. Ожидается название одного из типов загрузки xml-кода.

Типы загрузки xml-кода

Path	Загрузка кода из файла, расположенного по определенному пути.

Значение тэга <Xml> при атрибуте Type, равным Path: любое значение будет переведено в текстовое.

Show

Способ открытия дочерней формы.

Необязательный тэг. Значение тэга <Show>: не ожидается.

Если тэг <Show> отсутствует, то для атрибута Type используется значение None.

<Show Type="Modal" WithoutFocus="False" />

Атрибуты тэга <Show>

Type	Название типа открытия дочерней формы. Обязательный атрибут. Ожидается название одного из типов открытия дочерней формы.
WithoutFocus	Признак, определяющий, будет ли дочерняя форма открыта без фокуса. Необязательный атрибут. Ожидается логическое значение. Если атрибут WithoutFocus отсутствует, то используется значение False.

Типы открытия дочерней формы

Modal	Открыть форму модально
None	Открыть форму параллельно
Hide	Открыть форму параллельно, спрятав родительскую
Close	Открыть форму параллельно, закрыв родительскую (только если родительская форма - не стартовая)
Thread	Открыть форму в фоновом потоке

Multiple

Способ открытия еще одного экземпляра дочерней формы.

Необязательный тэг. Значение тэга <Multiple>: не ожидается.

Если тэг <Multiple> отсутствует, то для атрибута Allow используется значение False, а для атрибута Reload - значение True.

<Multiple Allow="False" Reload="True" />

Атрибуты тэга <Multiple>

Allow	Признак, определяющий, можно ли открыть еще один экземпляр дочерней формы. Необязательный атрибут. Ожидается логическое значение. Если атрибут Allow отсутствует, то используется значение False.
Reload	Признак, определяющий, будут ли повторно отправлены параметры в экземпляр открытой дочерней формы. Необязательный атрибут. Ожидается логическое значение. Если атрибут Reload отсутствует, то используется значение False. Данный атрибут актуален только, если атрибут Allow имеет значение False.

Parameters

Параметры, которые будут переданы на дочернюю форму.

Необязательный тэг. Значение тэга <Parameters>: список тэгов <Parameter>.

<Parameters>
  <Parameter Name="ParameterName1">ParameterValue1</Parameter>
  <Parameter Name="ParameterName2">ParameterValue2</Parameter>
</Parameters>

Тэг <Parameter>

Параметр, который будет передан на дочернюю форму.

Необязательный тэг. Значение тэга <Parameter>: любое значение.

Атрибуты тэга <Parameter>

Name	Название параметра. Обязательный атрибут. Значение атрибута Name: название одного из явных или неявных параметров дочерней формы.

UpdateResult

Способ изменения результата команды.

Необязательный тэг. Значение тэга <UpdateResult>: не ожидается.

Если тэг <UpdateResult> отсутствует, то для атрибута Type используется значение OnFormClose.

<UpdateResult Type="OnFormClose" />

Атрибуты тэга <UpdateResult>

Type	Название типа изменения результата команды. Обязательный атрибут. Значение атрибута Type: ожидается название одного из типов изменения результата команды.

Типы изменения результата команды

OnFormClose	Изменение результатов команды происходит только после закрытия дочерней формы
Always	Изменение результатов команды происходит мгновенно при любом изменении хотя бы одного явного (только явного, не неявного) параметра дочерней формы, даже без ее закрытия

Owner

Указание на родительскую форму для формы, открываемой в команде.

Необязательный тэг. Значение тэга <Owner>: не ожидается.

Если тэг <Owner> отсутствует, то для атрибута Form используется значение This.

Родительская форма определяет порядок каскадного закрытия форм, но не передачу параметров.

<Owner Form="This" />

Атрибуты тэга <Owner>

Form	Название типа указания на родительскую форму. Обязательный атрибут. Ожидается название одного из типов указания на родительскую форму.

Типы указания на родительскую форму

This	Родительской для формы, открываемой в команде, будет текущая форма
Parent	Родительской для формы, открываемой в команде, будет родительская форма текущей (другими словами, у текущей и открываемой формы будет одна и та же родительская форма)