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

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

Last updated