FileListBox

Графический объект; список файлов.

Шаблон FileListBox

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

<MyObject Name="" Type="FileListBox" 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="" />
  <!--Тэги, специфичные для FileListBox-->
  <View></View>
  <Sorting></Sorting>
  <MultiSelect></MultiSelect>
  <ShowTitle></ShowTitle>
  <AutoDownload></AutoDownload>
  <ShowThumbnails></ShowThumbnails>
  <ThumbnailWidth></ThumbnailWidth>
  <ThumbnailHeight></ThumbnailHeight>
  <ValueList>
    <DataConnection SourceDataConnection="">
      <Fields>
        <Field Name="" />
        <Field Name="" />
      </Fields>
    </DataConnection>
  </ValueList>
  <Value></Value>
</MyObject>

Описание FileListBox

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

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

Значением FileListBox считается реальное (не отображаемое, а именно реальное) значение выбранного элемента из списка.

<Object Name="FileListBoxName" />

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

Значение объекта: любое значение.

<Object Name="FileListBoxName"></Object>

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

View

Название типа стиля отображения элементов в списке в списке.

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

LargeIcon	Каждый элемент отображается в виде полноразмерного значка с меткой под ним.
SmallIcon	Каждый элемент отображается в виде небольшого значка с меткой справа.
List	Каждый элемент отображается в виде небольшого значка с меткой справа. Элементы располагаются в столбцах без заголовков столбцов.

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

<View>LargeIcon</View>

Sorting

Название типа сортировки элементов в списке.

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

None	Без сортировки
Ascending	Сортировка по возрастанию
Descending	Сортировка по убыванию

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

<Sorting>None</Sorting>

MultiSelect

Признак возможности выделения нескольких элементов списка.

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

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

<MultiSelect>False</MultiSelect>

ShowTitle

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

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

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

<ShowTitle>False</ShowTitle>

AutoDownload

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

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

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

<AutoDownload>False</AutoDownload>

ShowThumbnails

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

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

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

<ShowThumbnails>False</ShowThumbnails>

ThumbnailWidth

Ширина миниатюры.

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

Если тэг <ThumbnailWidth> отсутствует, то используется значение 32.

<ThumbnailWidth>32</ThumbnailWidth>

ThumbnailHeight

Высота миниатюры.

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

Если тэг <ThumbnailHeight> отсутствует, то используется значение 32.

<ThumbnailHeight>32</ThumbnailHeight>

ValueList

Элементы списка.

Необязательный тэг. Ожидается таблица с одним, двумя или более столбцами (например, ссылка на GetDataConnection).

Первое поле будет соответствовать реальному значению элемента, второе – его отображаемому значению (если второго поля нет, то отображаемое значение равно реальному). Все остальные поля игнорируются.

<ValueList>
  <DataConnection SourceDataConnection="SourceDataConnectionName">
    <Fields>
      <Field Name="Field1Name" />
      <Field Name="Field2Name" />
    </Fields>
  </DataConnection>
</ValueList>

Value

Значение, соответствующее реальному значению выделенного элемента.

Необязательный тэг. Значение тэга <Value>: любое значение.

<Value>Value</Value>

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

View

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

<Object Name="FileListBoxName">
  <Property Name="View" />
</Object>

Sorting

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

<Object Name="FileListBoxName">
  <Property Name="Sorting" />
</Object>

MultiSelect

Возвращает признак возможности выделения нескольких элементов списка.

<Object Name="FileListBoxName">
  <Property Name="MultiSelect" />
</Object>

ShowTitle

Возвращает признак, определяющий, показывать ли названия файлов.

<Object Name="FileListBoxName">
  <Property Name="ShowTitle" />
</Object>

AutoDownload

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

<Object Name="FileListBoxName">
  <Property Name="AutoDownload" />
</Object>

ShowThumbnails

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

<Object Name="FileListBoxName">
  <Property Name="ShowThumbnails" />
</Object>

ThumbnailWidth

Возвращает ширину миниатюры.

<Object Name="FileListBoxName">
  <Property Name="ThumbnailWidth" />
</Object>

ThumbnailHeight

Возвращает высоту миниатюры.

<Object Name="FileListBoxName">
  <Property Name="ThumbnailHeight" />
</Object>

ValueList

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

<Object Name="FileListBoxName">
  <Property Name="ValueList">
    <Parameters>
      <!--Значение тэга Parameter с атрибутом Name, равным Remote: любое значение будет переведено в логическое-->
      <!--Необязательный параметр. При отсутствии используется пустое значение -->
      <Parameter Name="Remote"></Parameter>
    </Parameters>
  </Property>
</Object>

LocalValueList

Возвращает элементы списка с путями на локальные файлы (таблица с двумя столбцами).

<Object Name="FileListBoxName">
  <Property Name="LocalValueList">
    <Parameters>
      <!--Значение тэга Parameter с атрибутом Name, равным Remote: любое значение будет переведено в логическое-->
      <!--Необязательный параметр. При отсутствии используется пустое значение -->
      <Parameter Name="Remote"></Parameter>
    </Parameters>
  </Property>
</Object>

SelectedCount

Возвращает количество выбранных элементов в списке.

<Object Name="FileListBoxName">
  <Property Name="SelectedCount" />
</Object>

SelectedIndex

Возвращает индекс выбранного элемента.

<Object Name="FileListBoxName">
  <Property Name="SelectedIndex" />
</Object>

SelectedIndices

Возвращает массив индексов выбранных элементов.

<Object Name="FileListBoxName">
  <Property Name="SelectedIndices" />
</Object>

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

View

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

Ожидается название одного из типов стиля отображения элементов в списке.

<Object Name="FileListBoxName">
  <Property Name="View">List</Property>
</Object>

Sorting

Задает название типа сортировки элементов в списке.

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

<Object Name="FileListBoxName">
  <Property Name="Sorting">Ascending</Property>
</Object>

MultiSelect

Задает признак возможности выделения нескольких элементов списка.

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

<Object Name="FileListBoxName">
  <Property Name="MultiSelect">True</Property>
</Object>

ShowTitle

Задает признак, определяющий, показывать ли названия файлов.

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

<Object Name="FileListBoxName">
  <Property Name="ShowTitle">True</Property>
</Object>

AutoDownload

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

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

<Object Name="FileListBoxName">
  <Property Name="AutoDownload">True</Property>
</Object>

ShowThumbnails

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

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

<Object Name="FileListBoxName">
  <Property Name="ShowThumbnails">True</Property>
</Object>

ThumbnailWidth

Задаёт ширину миниатюры.

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

<Object Name="FileListBoxName">
  <Property Name="ThumbnailWidth">128</Property>
</Object>

ThumbnailHeight

Задаёт высоту миниатюры.

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

<Object Name="FileListBoxName">
  <Property Name="ThumbnailHeight">128</Property>
</Object>

AddFile

Добавляет файл в список.

<Object Name="FileListBoxName">
  <!--Значение тэга Property: тэг Parameters со вложенными тэгами Parameter-->
  <Property Name="AddFile">
    <Parameters>
      <!--Значение тэга Parameter с атрибутом Name, равным Value: ожидается путь до файла, который будет добавлен в список-->
      <Parameter Name="Value">filename.ext</Parameter>
      <!--Значение тэга Parameter с атрибутом Name, равным Title: любое значение будет переведено в текстовое-->
      <!--Необязательный параметр. При отсутствии используется пустая строка-->
      <Parameter Name="Title">filename.ext</Parameter>
    </Parameters>
  </Property>
</Object>

Возможен сокращенный вариант записи:

<Object Name="FileListBoxName">
  <!--Значение тэга Property: ожидается путь до файла, который будет добавлен в список-->
  <Property Name="AddFile">filename.ext</Property>
</Object>

AddFiles

Добавляет несколько файлов в список.

<Object Name="FileListBoxName">
  <!--Значение тэга Property: тэг Parameters со вложенными тэгами Parameter-->
  <Property Name="AddFiles">
    <Parameters>
      <!--Значение тэга Parameter с атрибутом Name, равным Value: ожидается матрица с двумя столбцами-->
      <Parameter Name="Value"></Parameter>
    </Parameters>
  </Property>
</Object>

RemoveFileByIndex

Удаляет файл из списка.

Ожидается индекс элемента, который будет удалён.

<Object Name="FileListBoxName">
  <Property Name="RemoveFileByIndex">0</Property>
</Object>

RemoveFilesByIndices

Удаляет файлы из списка.

Ожидается массив индексов элементов, которые будут удалены.

<Object Name="FileListBoxName">
  <Property Name="RemoveFilesByIndices">0</Property>
</Object>

ValueList

Задает элементы списка.

Ожидается таблица с двумя столбцами (например, ссылка на GetDataConnection с указанием двух его полей).

<Object Name="FileListBoxName">
  <Property Name="ValueList">
    <DataConnection SourceDataConnection="SourceDataConnectionName">
      <Fields>
        <Field Name="Field1Name" />
        <Field Name="Field2Name" />
      </Fields>
    </DataConnection>
  </Property>
</Object>