Платформа WT
Синтаксис
База знаний

Button

Графический объект; кнопка, по нажатию на которую выполняются определенные команды.

Шаблон Button

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

<MyObject Name="" Type="Button" Assembly="BaseControls" ChangeForm="">
  <!--Тэги, общие для всех графических объектов-->
  <Top></Top>
  <Bottom></Bottom>
  <Left></Left>
  <Right></Right>
  <Height></Height>
  <Width></Width>
  <FontStyle></FontStyle>
  <ForeColor></ForeColor>
  <BackColor></BackColor>
  <Enabled></Enabled>
  <Visible></Visible>
  <Hint></Hint>
  <ContextMenu Name="" />
  <Change User="" Source="" ValueSet="" />
  <!--Тэги, специфичные для Button-->
  <Blink></Blink>
  <BlinkInterval></BlinkInterval>
  <FlatStyle></FlatStyle>
  <FlatBorderSize></FlatBorderSize>
  <FlatBorderColor></FlatBorderColor>
  <FlatMouseDownBackColor></FlatMouseDownBackColor>
  <FlatMouseOverBackColor></FlatMouseOverBackColor>
  <Image></Image>
  <ImageAlign></ImageAlign>
  <BackgroundImage></BackgroundImage>
  <BackgroundImageLayout></BackgroundImageLayout>
  <DisabledMode></DisabledMode>
  <DisabledText></DisabledText>
  <TextAlign></TextAlign>
  <Text></Text>
  <Commands StopOnError="" Lock="">
    <Command Name="" />
    <If>
      <When></When>
      <Then StopOnError="" Lock="">
        <Command Name="" />
      </Then>
      <ElseIf>
        <When></When>
        <Then StopOnError="" Lock="">
          <Command Name="">
            <Input Name="" />
            <Input Name="" />
          </Command>
        </Then>
      </ElseIf>
      <Else StopOnError="" Lock="">
        <Command Name="" />
      </Else>
    </If>
  </Commands>
</MyObject>

Описание Button

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

Значением Button считается текст, указанный на кнопке.

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

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

<Object Name="ButtonName">
  <Property Name="Text" />
</Object>

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

<Object Name="ButtonName" />

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

Для задания отображаемого на кнопке текста используется set-проперти Text:

<Object Name="ButtonName">
  <Property Name="Text">Text</Property>
</Object>

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

<Object Name="ButtonName">Text</Object>

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

Blink

Определяет мерцание надписи на кнопке.

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

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

<Blink>False</Blink>

BlinkInterval

Задает интервал мерцания надписи на кнопке (в миллисекундах).

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

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

<BlinkInterval>500</BlinkInterval>

FlatStyle

Задает тип границ кнопки.

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

Flat

Плоская

Popup

Плоская, пока не наведена мышь

Standard

Обычная

System

Определяется операционной системой

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

<FlatStyle>Standard</FlatStyle>

FlatBorderSize

Задает размер границы плоской кнопки (кнопки, свойство <FlatStyle> которой равно Flat).

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

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

<FlatBorderSize>1</FlatBorderSize>

FlatBorderColor

Задает цвет границы плоской кнопки (кнопки, свойство <FlatStyle> которой равно Flat).

Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb).

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

<FlatBorderColor>FlatBorderColor</FlatBorderColor>

FlatMouseDownBackColor

Задает цвет нажатой плоской кнопки (кнопки, свойство <FlatStyle> которой равно Flat).

Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb).

Если тэг <FlatMouseDownBackColor> отсутствует, то цвет рассчитывается автоматически.

<FlatMouseDownBackColor>FlatMouseDownBackColor</FlatMouseDownBackColor>

FlatMouseOverBackColor

Задает цвет плоской кнопки при наведении курсора мыши (кнопки, свойство <FlatStyle> которой равно Flat).

Необязательный тэг. Ожидается имя одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb).

Если тэг <FlatMouseOverBackColor> отсутствует, то цвет рассчитывается автоматически.

<FlatMouseOverBackColor>FlatMouseOverBackColor</FlatMouseOverBackColor>

Image

Путь до файла с графическим содержанием, которое будет расположено на кнопке.

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

<Image>Image</Image>

ImageAlign

Определяет тип положения картинки.

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

TopLeft

Слева сверху

TopCenter

По центру сверху

TopRight

Справа сверху

MiddleLeft

Слева посередине

MiddleCenter

По центру посередине

MiddleRight

Справа посередине

BottomLeft

Слева снизу

BottomCenter

По центру снизу

BottomRight

Справа снизу

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

<ImageAlign>MiddleCenter</ImageAlign>

BackgroundImage

Путь до файла с графическим содержанием, которое будет расположено на кнопке.

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

<BackgroundImage>BackgroundImage</BackgroundImage>

BackgroundImageLayout

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

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

None

Изображение выравнивается на кнопке вверху по левой стороне

Tile

Выполняется мозаичное заполнение изображением кнопки

Center

Изображение центрируется на кнопке

Stretch

Изображение растягивается на всю длину кнопки

Zoom

Изображение увеличивается в пределах кнопки

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

<BackgroundImageLayout>Tile</BackgroundImageLayout>

TextAlign

Определяет тип положения текста.

Необязательный тэг. Ожидается название одного из типов положения текста:

TopLeft

Слева сверху

TopCenter

По центру сверху

TopRight

Справа сверху

MiddleLeft

Слева посередине

MiddleCenter

По центру посередине

MiddleRight

Справа посередине

BottomLeft

Слева снизу

BottomCenter

По центру снизу

BottomRight

Справа снизу

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

<TextAlign>MiddleLeft</TextAlign>

Text

Текст на кнопке.

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

<Text>Текст</Text>

DisabledMode

Признак, при установке которого при нажатии на неактивную кнопку (Enabled = False) будет показано сообщение с текстом, указанным в тэге <DisabledText>.

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

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

<DisabledMode>False</DisabledMode>

DisabledText

Текст сообщения, которое будет показано по нажатию на неактивную кнопку с установленным признаком <DisabledMode>.

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

<DisabledText>Текст сообщения</DisabledText>

Commands

Список команд, которые будут выполнены при нажатии на кнопку.

Необязательный тэг. В качестве значения тэга ожидается список тэгов <Command> и/или конструкций <If>.

<Commands StopOnError="True"  Lock="">
  <Command Name="CommandName1" />
  <If>
    <When></When>
    <Then StopOnError="True" Lock="">
      <Command Name="CommandName2">
        <Input Name="InputName1">input 1</Input>
        <Input Name="InputName2">input 2</Input>
      </Command>
    </Then>
    <ElseIf>
      <When></When>
      <Then StopOnError="True" Lock="">
        <Command Name="CommandName3" />
      </Then>
    </ElseIf>
    <Else StopOnError="True" Lock="">
      <Command Name="CommandName4" />
    </Else>
  </If>
</Commands>

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

StopOnError

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

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

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

Lock

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

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

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

Тэг <Command>

Обращение к команде по имени для ее выполнения.

Необязательный тэг. В качестве значения тэга ожидается список тэгов <Input>.

<!--Вариант 1-->
<Command Name="CommandName1" />

<!--Вариант 2-->
<Command Name="CommandName2">
  <Input Name="InputName1">input 1</Input>
  <Input Name="InputName2">input 2</Input>
</Command>

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

Blink

Возвращает признак мерцания надписи на кнопке.

<Object Name="LabelName">
  <Property Name="Blink" />
</Object>

BlinkInterval

Возвращает интервал мерцания надписи на кнопке (в миллисекундах).

<Object Name="LabelName">
  <Property Name="BlinkInterval" />
</Object>

FlatStyle

Возвращает название типа границ кнопки.

<Object Name="ButtonName">
  <Property Name="FlatStyle" />
</Object>

FlatBorderSize

Возвращает размер границы плоской кнопки (кнопки, свойство <FlatStyle> которой равно Flat).

<Object Name="ButtonName">
  <Property Name="FlatBorderSize" />
</Object>

FlatBorderColor

Возвращает имя цвета границы плоской кнопки (кнопки, свойство <FlatStyle> которой равно Flat).

<Object Name="ButtonName">
  <Property Name="FlatBorderColor" />
</Object>

FlatMouseDownBackColor

Возвращает имя цвета нажатой плоской кнопки (кнопки, свойство <FlatStyle> которой равно Flat).

<Object Name="ButtonName">
  <Property Name="FlatMouseDownBackColor" />
</Object>

FlatMouseOverBackColor

Возвращает имя цвета плоской кнопки при наведении курсора мыши (кнопки, свойство <FlatStyle> которой равно Flat).

<Object Name="ButtonName">
  <Property Name="FlatMouseOverBackColor" />
</Object>

Image

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

<Object Name="ButtonName">
  <Property Name="Image" />
</Object>

ImageAlign

Возвращает название типа положения картинки.

<Object Name="ButtonName">
  <Property Name="ImageAlign" />
</Object>

BackgroundImage

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

<Object Name="ButtonName">
  <Property Name="BackgroundImage" />
</Object>

BackgroundImageLayout

Возвращает название типа расположения графического содержания на кнопке.

<Object Name="ButtonName">
  <Property Name="BackgroundImageLayout" />
</Object>

TextAlign

Возвращает название типа положения текста.

<Object Name="ButtonName">
  <Property Name="TextAlign" />
</Object>

Text

Возвращает текст на кнопке.

<Object Name="ButtonName">
  <Property Name="Text" />
</Object>

DisabledMode

Возвращает значение признака <DisabledMode>.

<Object Name="ButtonName">
  <Property Name="DisabledMode" />
</Object>

DisabledText

Возвращает текст сообщения, заданное для признака <DisabledText>.

<Object Name="ButtonName">
  <Property Name="DisabledText" />
</Object>

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

Blink

Задает признак мерцания надписи на кнопке.

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

<Object Name="LabelName">
  <Property Name="Blink">True</Property>
</Object>

BlinkInterval

Задает интервал мерцания надписи на кнопке (в миллисекундах).

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

<Object Name="LabelName">
  <Property Name="BlinkInterval">1000</Property>
</Object>

FlatStyle

Задает название типа границ кнопки.

Ожидается одно из названий типов границ кнопки.

<Object Name="ButtonName">
  <Property Name="FlatStyle">Popup</Property>
</Object>

FlatBorderSize

Задает размер границы плоской кнопки (кнопки, свойство <FlatStyle> которой равно Flat).

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

<Object Name="ButtonName">
  <Property Name="FlatBorderSize">1</Property>
</Object>

FlatBorderColor

Задает имя цвета границы плоской кнопки (кнопки, свойство <FlatStyle> которой равно Flat).

Ожидается название одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb).

<Object Name="ButtonName">
  <Property Name="FlatBorderColor">FlatBorderColor</Property>
</Object>

FlatMouseDownBackColor

Задает имя цвета нажатой плоской кнопки (кнопки, свойство <FlatStyle> которой равно Flat).

Ожидается название одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb).

<Object Name="ButtonName">
  <Property Name="FlatMouseDownBackColor">FlatMouseDownBackColor</Property>
</Object>

FlatMouseOverBackColor

Задает имя цвета плоской кнопки при наведении курсора мыши (кнопки, свойство <FlatStyle> которой равно Flat).

Ожидается название одного из цветов, описанных в форме или описание цвета в формате HTML (#rrggbb).

<Object Name="ButtonName">
  <Property Name="FlatMouseOverBackColor">FlatMouseOverBackColor</Property>
</Object>

Image

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

Любое значение будет переведено в текстовое.

<Object Name="ButtonName">
  <Property Name="Image" />
</Object>

ImageAlign

Задает название типа положения картинки.

Ожидается одно из названий типов положения картинки.

<Object Name="ButtonName">
    <Property Name="ImageAlign">TopLeft</Property>
</Object>

BackgroundImage

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

Любое значение будет переведено в текстовое.

<Object Name="ButtonName">
  <Property Name="BackgroundImage" />
</Object>

BackgroundImageLayout

Задает название типа расположения графического содержания на кнопке.

Ожидается одно из названий типов расположения графического содержания на кнопке.

<Object Name="ButtonName">
  <Property Name="BackgroundImageLayout" />
</Object>

TextAlign

Задает название типа положения текста.

Ожидается одно из названий типов положения текста.

<Object Name="ButtonName">
  <Property Name="TextAlign">TopLeft</Property>
</Object>

Text

Задает текст на кнопке.

Любое значение будет переведено в текстовое.

<Object Name="ButtonName">
  <Property Name="Text">Text</Property>
</Object>

DisabledMode

Задает значение признака <DisabledMode>.

<Object Name="ButtonName">
  <Property Name="DisabledMode" />
</Object>

DisabledText

Задает текст сообщения для признака <DisabledText>.

<Object Name="ButtonName">
  <Property Name="DisabledText" />
</Object>

Last updated