# FormShowCommand

## Шаблон FormShowCommand <a href="#template_form_show_command" id="template_form_show_command"></a>

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

## Описание FormShowCommand <a href="#description_form_show_command" id="description_form_show_command"></a>

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

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

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

## Тэги, специфичные для FormShowCommand <a href="#tags_form_show_command" id="tags_form_show_command"></a>

### Xml <a href="#xml" id="xml"></a>

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

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

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

#### Атрибуты тэга `<Xml>` <a href="#attributes_tag_xml" id="attributes_tag_xml"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="449.3333333333333"></th></tr></thead><tbody><tr><td align="center">Type</td><td><p>Название типа загрузки xml-код.</p><p></p><p>Обязательный атрибут. Ожидается название одного из <a href="#xml_code_loading_types">типов загрузки</a> xml-кода.</p></td></tr></tbody></table>

#### Типы загрузки xml-кода <a href="#xml_code_loading_types" id="xml_code_loading_types"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="449.3333333333333"></th></tr></thead><tbody><tr><td align="center">Path</td><td>Загрузка кода из файла, расположенного по определенному пути.</td></tr></tbody></table>

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

### Show <a href="#show" id="show"></a>

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

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

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

```xml
<Show Type="None"/>
```

#### Атрибуты тэга `<Show>` <a href="#attributes_tag_show" id="attributes_tag_show"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="449.3333333333333"></th></tr></thead><tbody><tr><td align="center">Type</td><td><p>Название <a href="#child_form_opening_types">типа открытия дочерней формы</a>.</p><p></p><p>Обязательный атрибут. Ожидается название одного из типов открытия дочерней формы.</p></td></tr></tbody></table>

#### Типы открытия дочерней формы <a href="#child_form_opening_types" id="child_form_opening_types"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="449.3333333333333"></th></tr></thead><tbody><tr><td align="center">None</td><td>Открыть форму параллельно</td></tr><tr><td align="center">Close</td><td>Открыть форму параллельно, закрыв родительскую.</td></tr><tr><td align="center">Popup</td><td>Открыть форму как всплывающую</td></tr><tr><td align="center">Modal</td><td>Открыть форму модально</td></tr></tbody></table>

### Parameters <a href="#parameters" id="parameters"></a>

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

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

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

#### Тэг `<Parameter>` <a href="#parameters_parameter" id="parameters_parameter"></a>

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

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

#### Атрибуты тэга `<Parameter>` <a href="#attributes_tag_parameters_parameter" id="attributes_tag_parameters_parameter"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="449.3333333333333"></th></tr></thead><tbody><tr><td align="center">Name</td><td><p>Название параметра.</p><p></p><p>Обязательный атрибут. Значение атрибута <code>Name</code>: название одного из явных или неявных параметров дочерней формы.</p></td></tr></tbody></table>

### UpdateResult <a href="#update_result" id="update_result"></a>

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

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

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

```xml
<UpdateResult Type="OnFormClose" />
```

#### Атрибуты тэга `<UpdateResult>` <a href="#attributes_tag_update_result" id="attributes_tag_update_result"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="449.3333333333333"></th></tr></thead><tbody><tr><td align="center">Type</td><td><p>Название типа изменения результата команды.</p><p></p><p>Обязательный атрибут. Значение атрибута <code>Type</code>: ожидается название одного из <a href="#command_result_edit_types">типов изменения результата команды</a>.</p></td></tr></tbody></table>

#### Типы изменения результата команды <a href="#command_result_edit_types" id="command_result_edit_types"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="449.3333333333333"></th></tr></thead><tbody><tr><td align="center">OnFormClose</td><td>Изменение результатов команды происходит только после закрытия дочерней формы</td></tr><tr><td align="center">Always</td><td>Изменение результатов команды происходит мгновенно при любом изменении хотя бы одного явного (только явного, не неявного) параметра дочерней формы, даже без ее закрытия</td></tr></tbody></table>