ProgressBar
Индикатор, отображающий выполнение определенного процесса. Элемент пользовательского интерфейса.
Шаблон ProgressBar
Перечень всех возможных тэгов объекта:
<MyObject Name="ProgressBarName" Type="ProgressBar" Assembly="BaseControls">
<!--Тэги, общие для всех графических объектов-->
<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="" />
<!--Тэги, специфичные для ProgressBar-->
<Custom Value="" />
<Minimum></Minimum>
<Maximum></Maximum>
<Value></Value>
<BorderColor></BorderColor>
<BorderWidth></BorderWidth>
<ChannelHeight></ChannelHeight>
<ChannelGradient></ChannelGradient>
<ChannelFirstColor></ChannelFirstColor>
<ChannelSecondColor></ChannelSecondColor>
<SliderHeight></SliderHeight>
<SliderGradient></SliderGradient>
<SliderFirstColor></SliderFirstColor>
<SliderSecondColor></SliderSecondColor>
<TextAlign></TextAlign>
<TextFormat></TextFormat>
<StringFormat></StringFormat>
<Animation Value="" />
<AnimationColor></AnimationColor>
<Speed></Speed>
</MyObject>
Описание ProgressBar
<MyObject Name="ProgressBarName" Type="ProgressBar" Assembly="BaseControls">
<!--Тэги, общие для всех графических объектов-->
<!--Тэги, специфичные для ProgressBar-->
</MyObject>
Значением ProgressBar считается текст, указанный в поле.
Получение значения
Для получения указанного в поле текста используется get-проперти Value:
<Object Name="ProgressBarName">
<Property Name="Value" />
</Object>
Рекомендуется использовать сокращенный вариант записи:
<Object Name="ProgressBarName" />
Задание значения
Для задания значения текстовому полю используется set-проперти Value:
<Object Name="ProgressBarName">
<Property Name="Value">10</Property>
</Object>
Рекомендуется использовать сокращенный вариант записи:
<Object Name="ProgressBarName">10</Object>
Тэги, специфичные для ProgressBar
Custom
Признак, включающий возможность настраивать стиль прогресс бара. Если признак имеет значение False, то для внешнего вида прогресс бара используются настройки операционной системы.
Необязательный тэг. Значение тэга не ожидается.
Необязательный атрибут Value
ожидает логическое значение. По умолчанию используется значение False.
<Custom Value="True" />
Value
Задает текущее значение прогресс бара.
Необязательный тэг. Ожидается положительное целочисленное значение.
По умолчанию используется значение 0.
<Value>0</Value>
Maximum
Задает максимальное значение прогресс бара.
Необязательный тэг. Ожидается положительное целочисленное значение.
По умолчанию используется значение 100.
<Maximum>200</Maximum>
Minimum
Задает минимальное значение прогресс бара.
Необязательный тэг. Ожидается положительное целочисленное значение.
По умолчанию используется значение 0.
<Minimum>0</Minimum>
BorderColor
Задает цвет границы прогресс бара.
Используется, только если тэг <Custom>
имеет значение True.
Необязательный тег. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).
По умолчанию используется черный цвет.
<BorderColor>#FF9800</BorderColor>
BorderWidth
Задает толщину границы прогресс бара.
Используется, только если тэг <Custom>
имеет значение True.
Необязательный тэг. Ожидается положительное целочисленное значение.
По умолчанию используется значение 0.
<BorderWidth>2</BorderWidth>
ChannelHeight
Задает высоту канала.
Используется, только если тэг <Custom>
имеет значение True.
Необязательный тэг. Ожидается положительное целочисленное значение.
По умолчанию используется значение 35
<ChannelHeight>40</ChannelHeight>
ChannelGradient
Признак, включающий градиентную заливку фона канала.
Используется, только если тэг <Custom>
имеет значение True.
Необязательный тэг. Ожидается логическое значение:
True
Градиентная заливка фона канала.
Цвета задаются в тэгах <ChannelFirstColor>
и <ChannelSecondColor>
.
False
Однотонная заливка фона канала.
Цвет задается в тэге <ChannelFirstColor>
.
По умолчанию используется значение False.
<ChannelGradient>True</ChannelGradient>
ChannelFirstColor
Задает основной цвет канала.
Используется, только если тэг <Custom>
имеет значение True.
Необязательный тег. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).
По умолчанию используется Transparent
<ChannelFirstColor>#757575</ChannelFirstColor>
ChannelSecondColor
Задает второй цвет канала.
Используется, только если тэг <Custom>
имеет значение True, и свойству ChannelGradient задано значение True.
Необязательный тег. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).
По умолчанию используется Gray
<ChannelSecondColor>#9E9E9E</ChannelSecondColor>
SliderHeight
Задает высоту слайдера.
Используется, только если тэг <Custom>
имеет значение True.
Необязательный тэг. Ожидается положительное целочисленное значение.
По умолчанию используется значение 35
<SliderHeight>40</SliderHeight>
SliderGradient
Признак, включающий градиентную заливку слайдера.
Используется, только если тэг <Custom>
имеет значение True.
Необязательный тэг. Ожидается логическое значение:
True
Градиентная заливка слайдера.
Цвета задаются в тэгах <SliderFirstColor>
и <SliderSecondColor>
.
False
Однотонная заливка слайдера.
Цвет задается в тэге <SliderFirstColor>
.
По умолчанию используется значение False.
<SliderGradient>True</SliderGradient>
SliderFirstColor
Задает основной цвет слайдера.
Используется, только если тэг <Custom>
имеет значение True.
Необязательный тег. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).
По умолчанию используется LightGreen
<SliderFirstColor>#689F38</SliderFirstColor>
SliderSecondColor
Задает второй цвет слайдера.
Используется, только если тэг <Custom>
имеет значение True, и свойству SliderGradient задано значение True.
Необязательный тег. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).
По умолчанию используется YellowGreen
<SliderSecondColor>#CDDC39</SliderSecondColor>
TextAlign
Используется, чтобы указать способ выравнивания текста по горизонтали.
Используется, только если тэг <Custom>
имеет значение True.
Необязательный тэг. Ожидается название одного из способов выравнивания текста по горизонтали.:
TopLeft
Слева сверху
TopCenter
По центру сверху
TopRight
Справа сверху
MiddleLeft
Слева посередине
MiddleCenter
По центру посередине
MiddleRight
Справа посередине
Slide
Плывущий по верху текст
None
Текст отсутствует
По умолчанию используется значение None.
<TextAlign>MiddleCenter</TextAlign>
TextFormat
Задает название формата отображения текста.
Используется, только если тэг <Custom>
имеет значение True, а свойство TextAlign имеет значение отличное от None.
Необязательный тэг. Ожидается название одного из типов положения текста:
Percentage
Отображается текущее значение в виде процентов, рассчитанных по формуле: Value/Maximum * 100
Value
Отображается текущее значение прогресс бара.
ValueOverMaximum
Отображается строка вида: Value/Maximum
Text
Формат строки задается в тэге <StringFormat>
По умолчанию принимает значение Value.
<TextFormat>ValueOverMaximum</TextFormat>
StringFormat
Задает шаблон строки для отображаемого текста.
Используется, только если тэг <Custom>
имеет значение True, а тэг <TextFormat>
- значение Text.
Необязательный тэг. Любое значение будет переведено в текстовое.
Поддерживает две переменные для получения собственных свойств: {0} - Value, {1} - Maximum.
<StringFormat>{0} из {1}</StringFormat>
Animation
Признак, включающий анимацию при заполнении прогресс бара.
Используется только если тэг <Custom>
имеет значение True.
Необязательный тэг. Значение тэга не ожидается.
Необязательный атрибут Value
ожидает логическое значение. По умолчанию используется значение False.
<Animation Value="True" />
AnimationColor
Задает цвет анимации.
Используется, только если тэг <Custom>
имеет значение True и анимация прогресс бара включена.
Необязательный тег. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).
По умолчанию используется YellowGreen.
<AnimationColor>#CDDC39</AnimationColor>
Speed
Задает скорость анимации.
Используется только если тэг <Custom>
имеет значение True и анимация прогресс бара включена.
Необязательный тэг. Ожидается положительное целочисленное значение.
По умолчанию используется значение 2.
<Speed>2</Speed>
Get-проперти для получения свойств
Value
Возвращает текущее значение прогресс бара.
<Object Name="ProgressBarName">
<Property Name="Value" />
</Object>
Maximum
Возвращает максимальное значение прогресс бара.
<Object Name="ProgressBarName">
<Property Name="Maximum" />
</Object>
Minimum
Возвращает минимальное значение прогресс бара
<Object Name="ProgressBarName">
<Property Name="Minimum" />
</Object>
BorderColor
Возвращает цвет границы прогресс бара.
<Object Name="ProgressBarName">
<Property Name="BorderColor" />
</Object>
BorderWidth
Возвращает толщину границы прогресс бара.
<Object Name="ProgressBarName">
<Property Name="BorderWidth" />
</Object>
ChannelHeight
Возвращает высоту канала.
<Object Name="ProgressBarName">
<Property Name="ChannelHeight" />
</Object>
ChannelGradient
Возвращает тип заливки фона канала.
<Object Name="ProgressBarName">
<Property Name="ChannelGradient" />
</Object>
ChannelFirstColor
Возвращает основной цвет канала.
<Object Name="ProgressBarName">
<Property Name="ChannelFirstColor" />
</Object>
ChannelSecondColor
Возвращает второй цвет канала.
<Object Name="ProgressBarName">
<Property Name="ChannelSecondColor" />
</Object>
SliderHeight
Возвращает высоту слайдера.
<Object Name="ProgressBarName">
<Property Name="SliderHeight" />
</Object>
SliderGradient
Возвращает типа заливки слайдера.
<Object Name="ProgressBarName">
<Property Name="SliderGradient" />
</Object>
SliderFirstColor
Возвращает основной цвет слайдера.
<Object Name="ProgressBarName">
<Property Name="SliderFirstColor" />
</Object>
SliderSecondColor
Возвращает второй цвет слайдера.
<Object Name="ProgressBarName">
<Property Name="SliderSecondColor" />
</Object>
TextAlign
Возвращает название способа выравнивания текста по горизонтали.
<Object Name="ProgressBarName">
<Property Name="TextAlign" />
</Object>
TextFormat
Возвращает название типа формата отображаемого текста.
<Object Name="ProgressBarName">
<Property Name="TextFormat" />
</Object>
StringFormat
Возвращает шаблон строки отображаемого текста.
<Object Name="ProgressBarName">
<Property Name="StringFormat" />
</Object>
Set-проперти для динамического задания свойств
Value
Задает текущее значение прогресс бара.
Ожидается положительное целочисленное значение.
<Object Name="ProgressBarName">
<Property Name="Value">10</Property>
</Object>
Maximum
Задает максимальное значение прогресс бара.
Ожидается положительное целочисленное значение.
<Object Name="ProgressBarName">
<Property Name="Maximum">200</Property>
</Object>
Last updated