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>