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>
<BlinkPart></BlinkPart>
<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 считается текст, указанный на кнопке.
Получение значения
Для получения указанного на кнопке текста используется get-проперти Text:
<Object Name="ButtonName">
<Property Name="Text" />
</Object>
Рекомендуется использовать сокращенный вариант записи:
<Object Name="ButtonName" />
Задание значения
Для задания отображаемого на кнопке текста используется set-проперти Text:
<Object Name="ButtonName">
<Property Name="Text">Text</Property>
</Object>
Рекомендуется использовать сокращенный вариант записи:
<Object Name="ButtonName">Text</Object>
Тэги, специфичные для Button
Blink
Признак, включающий режим мигания.
Необязательный тэг. Ожидается логическое значение.
По умолчанию используется значение False.
<Blink>True</Blink>
BlinkInterval
Задает интервал мигания (в миллисекундах).
Необязательный тэг. Ожидается целочисленное значение.
По умолчанию используется значение 500.
<BlinkInterval>500</BlinkInterval>
BlinkPart
Признак, определяющий режим мигания: только текст, только изображение или текст и изображение одновременно.
Необязательный тэг. Ожидается название одного из режимов:
All
Мигают и текст и изображение
Text
Мигает только текст
Image
Мигает только изображение
По умолчанию используется значение All.
<BlinkPart>Image</BlinkPart>
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>
<Commands>
StopOnError
Признак, определяющий, будет ли остановлено выполнение команд, если при выполнении очередной произойдет ошибка.
Необязательный атрибут. Ожидается логическое значение.
По умолчанию используется значение True.
Lock
Признак, определяющий, будет ли блокироваться форма при выполнении команд.
Необязательный атрибут. Ожидается логическое значение.
По умолчанию используется значение False.
Тэг <Command>
<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>
BlinkPart
Возвращает название режима мигания.
<Object Name="ButtonName">
<Property Name="BlinkPart" />
</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>
BlinkPart
Задает название режима мигания.
Ожидается одно из названий режимов мигания.
<Object Name="ButtonName">
<Property Name="BlinkPart">Text</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