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

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

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

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

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

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

Для задания значения текстовому полю используется set-проперти Value:

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

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

Custom

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

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

Необязательный атрибут Value ожидает логическое значение. По умолчанию используется значение False.

Value

Задает текущее значение прогресс бара.

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

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

Maximum

Задает максимальное значение прогресс бара.

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

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

Minimum

Задает минимальное значение прогресс бара.

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

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

BorderColor

Задает цвет границы прогресс бара. Используется, только если тэг <Custom> имеет значение True.

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

По умолчанию используется черный цвет.

BorderWidth

Задает толщину границы прогресс бара. Используется, только если тэг <Custom> имеет значение True.

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

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

ChannelHeight

Задает высоту канала. Используется, только если тэг <Custom> имеет значение True.

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

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

ChannelGradient

Признак, включающий градиентную заливку фона канала. Используется, только если тэг <Custom> имеет значение True.

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

True

Градиентная заливка фона канала. Цвета задаются в тэгах <ChannelFirstColor> и <ChannelSecondColor>.

False

Однотонная заливка фона канала. Цвет задается в тэге <ChannelFirstColor>.

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

ChannelFirstColor

Задает основной цвет канала. Используется, только если тэг <Custom> имеет значение True.

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

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

ChannelSecondColor

Задает второй цвет канала. Используется, только если тэг <Custom> имеет значение True, и свойству ChannelGradient задано значение True.

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

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

SliderHeight

Задает высоту слайдера. Используется, только если тэг <Custom> имеет значение True.

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

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

SliderGradient

Признак, включающий градиентную заливку слайдера. Используется, только если тэг <Custom> имеет значение True.

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

True

Градиентная заливка слайдера. Цвета задаются в тэгах <SliderFirstColor> и <SliderSecondColor>.

False

Однотонная заливка слайдера. Цвет задается в тэге <SliderFirstColor>.

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

SliderFirstColor

Задает основной цвет слайдера. Используется, только если тэг <Custom> имеет значение True.

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

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

SliderSecondColor

Задает второй цвет слайдера. Используется, только если тэг <Custom> имеет значение True, и свойству SliderGradient задано значение True.

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

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

TextAlign

Используется, чтобы указать способ выравнивания текста по горизонтали. Используется, только если тэг <Custom> имеет значение True.

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

TopLeft

Слева сверху

TopCenter

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

TopRight

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

MiddleLeft

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

MiddleCenter

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

MiddleRight

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

Slide

Плывущий по верху текст

None

Текст отсутствует

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

TextFormat

Задает название формата отображения текста. Используется, только если тэг <Custom> имеет значение True, а свойство TextAlign имеет значение отличное от None.

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

Percentage

Отображается текущее значение в виде процентов, рассчитанных по формуле: Value/Maximum * 100

Value

Отображается текущее значение прогресс бара.

ValueOverMaximum

Отображается строка вида: Value/Maximum

Text

Формат строки задается в тэге <StringFormat>

По умолчанию принимает значение Value.

StringFormat

Задает шаблон строки для отображаемого текста. Используется, только если тэг <Custom> имеет значение True, а тэг <TextFormat> - значение Text.

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

Поддерживает две переменные для получения собственных свойств: {0} - Value, {1} - Maximum.

Animation

Признак, включающий анимацию при заполнении прогресс бара. Используется только если тэг <Custom> имеет значение True.

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

Необязательный атрибут Value ожидает логическое значение. По умолчанию используется значение False.

AnimationColor

Задает цвет анимации. Используется, только если тэг <Custom> имеет значение True и анимация прогресс бара включена.

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

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

Speed

Задает скорость анимации. Используется только если тэг <Custom> имеет значение True и анимация прогресс бара включена.

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

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

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

Value

Возвращает текущее значение прогресс бара.

Maximum

Возвращает максимальное значение прогресс бара.

Minimum

Возвращает минимальное значение прогресс бара

BorderColor

Возвращает цвет границы прогресс бара.

BorderWidth

Возвращает толщину границы прогресс бара.

ChannelHeight

Возвращает высоту канала.

ChannelGradient

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

ChannelFirstColor

Возвращает основной цвет канала.

ChannelSecondColor

Возвращает второй цвет канала.

SliderHeight

Возвращает высоту слайдера.

SliderGradient

Возвращает типа заливки слайдера.

SliderFirstColor

Возвращает основной цвет слайдера.

SliderSecondColor

Возвращает второй цвет слайдера.

TextAlign

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

TextFormat

Возвращает название типа формата отображаемого текста.

StringFormat

Возвращает шаблон строки отображаемого текста.

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

Value

Задает текущее значение прогресс бара.

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

Maximum

Задает максимальное значение прогресс бара.

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

Last updated