TimeTable

Графический объект; таблица, отображающая в строках интервалы времени для набора элементов за указанный период.

Шаблон TimeTable

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

<MyObject Name="" Type="TimeTable" Assembly="ComplexControls" 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>
  <Change User="" Source="" ValueSet="" />
  <!--Тэги, специфичные для TimeTable-->
  <RowHeight Value="" />
  <ColumnHeadersHeight Value="" />
  <ColumnHeadersVisible Value="" />
  <RowHeadersWidth Value="" />
  <RowHeadersVisible Value="" />
  <BackgroundColor Value="" />
  <BorderStyle Value="" />
  <CellBorderStyle Value="" />
  <AutoSizeRowsMode Value="" />
  <ValueSeparator Value="" />
  <ColumnWidth Value="" />
  <ColumnAlignment Value="" />
  <ColumnHeaderAlignment Value="" />
  <DateStart></DateStart>
  <DateFinish></DateFinish>
  <Data>
    <DataConnection SourceDataConnection="DataPrimaryGetDataConnection">
      <SourceQuery Name="Items">
        <Fields>
          <Field Name="" />
          <Field Name="" />
        </Fields>
      </SourceQuery>
      <SourceQuery Name="Colors">
        <Fields>
          <Field Name="" />
          <Field Name="" />
          <Field Name="" />
          <Field Name="" />
        </Fields>
      </SourceQuery>
      <SourceQuery Name="Intervals">
        <Fields>
          <Field Name="" />
          <Field Name="" />
          <Field Name="" />
          <Field Name="" />
          <Field Name="" />
          <Field Name="" />
          <Field Name="" />
          <Field Name="" />
        </Fields>
      </SourceQuery>
    </DataConnection>
  </Data>
  <Interval Type="" Value="" TitleFormat="" />
  <MultiSelect></MultiSelect>
</MyObject>

Описание TimeTable

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

TimeTable не имеет значения.

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

RowHeight

Высота строк с данными в таблице.

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

Если тэг <RowHeight> отсутствует, то для атрибута Value используется стандартное значение .NET.

<RowHeight Value="22" />

Атрибуты тэга <RowHeight>

Value

Значение. Обязательный атрибут. Ожидается целочисленное значение.

ColumnHeadersHeight

Высота "шапки" таблицы.

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

Если тэг <ColumnHeadersHeight> отсутствует, то для атрибута Value используется стандартное значение .NET.

<ColumnHeadersHeight Value="21" />

Атрибуты тэга <ColumnHeadersHeight>

Value

Значение. Обязательный атрибут. Ожидается целочисленное значение.

ColumnHeadersVisible

Признак, определяющий, показывать или нет "шапку" таблицы.

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

Если тэг <ColumnHeadersVisible> отсутствует, то для атрибута Value используется значение True.

<ColumnHeadersVisible Value="True" />

Атрибуты тэга <ColumnHeadersVisible>

Value

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

RowHeadersWidth

Ширина "нулевого" столбца таблицы, где расположены названия элементов.

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

Если тэг <RowHeadersWidth> отсутствует, то для атрибута Value используется значение 100.

<RowHeadersWidth Value="40" />

Атрибуты тэга <RowHeadersWidth>

Value

Значение. Обязательный атрибут. Ожидается целочисленное значение.

RowHeadersVisible

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

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

Если тэг <RowHeadersVisible> отсутствует, то для атрибута Value используется значение True.

<RowHeadersVisible Value="True" />

Атрибуты тэга <RowHeadersVisible>

Value

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

BackgroundColor

Цвет фона таблицы.

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

Если тэг <BackgroundColor> отсутствует, то для атрибута Value используется стандартное значение .NET.

<BackgroundColor Value="BackgroundColor" />

Атрибуты тэга <BackgroundColor>

Value

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

BorderStyle

Название типа границ таблицы.

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

Если тэг <BorderStyle> отсутствует, то для атрибута Value используется значение FixedSingle.

<BorderStyle Value="FixedSingle" />

Атрибуты тэга <BorderStyle>

Value

Значение. Обязательный атрибут. Ожидается название одного из типов границ таблицы.

Типы границ таблицы

None	Нет границ
FixedSingle	Одиночная плоская
Fixed3D	Одиночная объемная

CellBorderStyle

Название стиля границ ячеек в таблице.

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

Если тэг <CellBorderStyle> отсутствует, то для атрибута Value используется значение Single.

<CellBorderStyle Value="Single" />

Атрибуты тэга <CellBorderStyle>

Value

Значение. Обязательный атрибут. Ожидается название одного из стилей границ ячеек в таблице.

Стили границ ячеек

Custom	Граница, которая была настроена
Single	Одинарная граница
Raised	Трехмерная выпуклая граница
Sunken	Трехмерная утопленная граница
None	Отсутствие границ
SingleVertical	Вертикальная одинарная граница
RaisedVertical	Вертикальная трехмерная выпуклая граница
SunkenVertical	Вертикальная трехмерная утопленная граница
SingleHorizontal	Горизонтальная одинарная граница
RaisedHorizontal	Горизонтальная трехмерная выпуклая граница
SunkenHorizontal	Горизонтальная трехмерная утопленная граница

AutoSizeRowsMode

Название типа автоматического изменения высоты строк таблицы.

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

Если тэг <AutoSizeRowsMode> отсутствует, то для атрибута Value используется значение None.

<AutoSizeRowsMode Value="None" />

Атрибуты тэга <AutoSizeRowsMode>

Value

Значение. Обязательный атрибут. Ожидается название одного из типов автоматического изменения высоты строк таблицы.

Типы автоматического изменения высоты строк таблицы

None	Нет автоматического изменения высоты строк таблицы
AllCells	Высота строк изменяется в соответствии с содержимым всех ячеек в строках, включая ячейки заголовка
AllCellsExceptHeaders	Высота строк изменяется в соответствии с содержимым всех ячеек в строках, исключая ячейки заголовка
AllHeaders	Высота строк изменяется в соответствии с содержимым заголовка строк
DisplayedCells	Высота строк изменяется в соответствии с содержимым всех ячеек в строках, отображаемых в текущий момент на экране, включая ячейки заголовка
DisplayedCellsExceptHeaders	Высота строк изменяется в соответствии с содержимым всех ячеек в строках, отображаемых в текущий момент на экране, исключая ячейки заголовка
DisplayedHeaders	Высота строк изменяется в соответствии с содержимым заголовков строк, отображаемых в текущий момент на экране

ValueSeparator

Текстовый разделитель для нескольких значений в одной ячейке таблицы.

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

Если тэг <ValueSeparator> отсутствует, то для атрибута Value используется значение " ".

Поддерживается символ "\r", который интерпретируется как перенос на новую строку.

<ValueSeparator Value="\r" />

Атрибуты тэга <ValueSeparator>

Value

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

ColumnWidth

Ширина столбцов таблицы.

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

Если тэг <ColumnWidth> отсутствует, то для атрибута Value используется значение 50.

<ColumnWidth Value="50" />

Атрибуты тэга <ColumnWidth>

Value

Значение. Обязательный атрибут. Ожидается положительное целочисленное значение.

ColumnAlignment

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

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

Если тэг <ColumnAlignment> отсутствует, то для атрибута Value используется значение NotSet.

<ColumnAlignment Value="NotSet" />

Атрибуты тэга <ColumnAlignment>

Value

Значение. Обязательный атрибут. Ожидается название одного из типов положения содержимого ячейки столбца.

Типы положения содержимого ячейки столбца

NotSet	Не установлено
TopLeft	Содержимое выравнивается по верхнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении
TopCenter	Содержимое выравнивается по верхнему краю в вертикальном направлении и по центру ячейки
TopRight	Содержимое выравнивается по верхнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении
MiddleLeft	Содержимое выравнивается вертикально по середине и горизонтально по левому краю ячейки в горизонтальном направлении
MiddleCenter	Содержимое выравнивается по вертикальному и горизонтальному центру ячейки
MiddleRight	Содержимое выравнивается вертикально по середине и горизонтально по правому краю ячейки в горизонтальном направлении
BottomLeft	Содержимое выравнивается по нижнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении
BottomCenter	Содержимое выравнивается по нижнему краю в вертикальном направлении и по центру ячейки
BottomRight	Содержимое выравнивается по нижнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении

ColumnHeaderAlignment

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

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

Если тэг <ColumnHeaderAlignment> отсутствует, то для атрибута Value используется значение NotSet.

<ColumnHeaderAlignment Value="NotSet" />

Атрибуты тэга <ColumnHeaderAlignment>

Value

Значение. Обязательный атрибут. Ожидается название одного из типов положения содержимого ячейки столбца.

DateStart

Начальная дата периода, начиная с которой интервалы времени будут отображаться в таблице.

Обязательный тэг. Ожидается значение даты/времени.

<DateStart>01.05.2014</DateStart>

DateFinish

Конечная дата периода, после которой интервалы времени перестают отображаться в таблице.

Обязательный тэг. Ожидается значение даты/времени.

<DateFinish>01.06.2014</DateFinish>

Data

Элементы, временные интервалы, относящиеся к элементам, и цвета временных интервалов.

Обязательный тэг. Ожидается соединение с данными с тремя таблицами: 1-ая - с двумя полями, 2-ая - с двумя или четырьмя, 3-я - с семью или восьмью.

Первая таблица соответствует списку элементов: первое поле будет соответствовать идентификатору элемента, второе - его отображаемому значению.

Второй вариант интерпретации полей для таблицы элементов: первое поле будет соответствовать идентификатору элемента, второе - его отображаемому значению, третье - идентификатору цвета фона ячеек строки по умолчанию.

Вторая таблица соответствует цветам временных интервалов: первое поле будет соответствовать идентификатору цвета, второе - системному названию цвета в среде .NET (например, "Red", "Yellow" и другие).

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

Третья таблица соответствует временным интервалам: первое поле будет соответствовать идентификатору интервала времени, второе - идентификатору элемента, к которому относится данный интервал, третье - тексту, который будет расположен в первой ячейке таблицы, куда попадет интервал, четвертое - всплывающей подсказке, которая также будет расположена в первой ячейке, с которой начинается интервал, пятое - дате начала интервала, шестое - дате окончания интервала, седьмое - идентификатору цвета интервала, восьмое - признак отображения отметки на интервале в виде восклицательного знака (при пустом значении отметка отображается при наличии всплывающей подсказки).

В таблице временных интервалов восьмое поле является необязательным: при его отсутствии отметка в виде восклицательного знака на интервале отображается при наличии всплывающей подсказки.

<Data>
  <DataConnection SourceDataConnection="DataPrimaryGetDataConnection">
    <SourceQuery Name="Items">
      <Fields>
        <Field Name="ItemId" />
        <Field Name="Title" />
        <Field Name="ColorId" />
      </Fields>
    </SourceQuery>
    <SourceQuery Name="Colors">
      <Fields>
        <Field Name="ColorId" />
        <Field Name="Red" />
        <Field Name="Green" />
        <Field Name="Blue" />
      </Fields>
    </SourceQuery>
    <SourceQuery Name="Intervals">
      <Fields>
        <Field Name="IntervalId" />
        <Field Name="ItemId" />
        <Field Name="Text" />
        <Field Name="Hint" />
        <Field Name="IntervalDateStart" />
        <Field Name="IntervalDateFinish" />
        <Field Name="ColorId" />
        <Field Name="HasMark" />
      </Fields>
    </SourceQuery>
  </DataConnection>
</Data>

Interval

Настройки интервала времени одного столбца таблицы.

Обязательный тэг. Значение тэга <Interval>: не ожидается.

<Interval Type="Days" Value="1" TitleFormat="dd" />

Атрибуты тэга <Interval>

Type	Тип единиц измерения интервала столбца. Обязательный атрибут. Ожидается название одного из типов единиц измерения интервала столбца.
Value	Количество единиц времени выбранного типа в интервале столбца. Обязательный атрибут. Ожидается положительное целочисленное значение.
TitleFormat	Формат вывода единиц времени выбранного типа в интервале столбца (например, "HH:mm"). Обязательный атрибут. Любое значение будет переведено в текстовое.

Типы единиц измерения интервала

Seconds	Секунды
Minutes	Минуты
Hours	Часы
Days	Дни
Months	Месяцы
Years	Годы

MultiSelect

Признак, определяющий, может ли пользователь выделять ячейки одновременно для нескольких элементов (в нескольких строках таблицы).

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

<MultiSelect>False</MultiSelect>

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

RowHeight

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

<Object Name="TimeTableName">
  <Property Name="RowHeight" />
</Object>

ColumnHeadersHeight

Возвращает высоту "шапки" таблицы.

<Object Name="TimeTableName">
  <Property Name="ColumnHeadersHeight" />
</Object>

ColumnHeadersVisible

Возвращает признак, определяющий, показывать или нет "шапку" таблицы.

<Object Name="TimeTableName">
  <Property Name="ColumnHeadersVisible" />
</Object>

RowHeadersWidth

Возвращает ширину "нулевого" столбца таблицы, где расположены названия элементов.

<Object Name="TimeTableName">
  <Property Name="RowHeadersWidth" />
</Object>

RowHeadersVisible

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

<Object Name="TimeTableName">
  <Property Name="RowHeadersVisible" />
</Object>

BackgroundColor

Возвращает имя цвета фона таблицы.

<Object Name="TimeTableName">
  <Property Name="BackgroundColor" />
</Object>

BorderStyle

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

<Object Name="TimeTableName">
  <Property Name="BorderStyle" />
</Object>

CellBorderStyle

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

<Object Name="TimeTableName">
  <Property Name="CellBorderStyle" />
</Object>

AutoSizeRowsMode

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

<Object Name="TimeTableName">
  <Property Name="AutoSizeRowsMode" />
</Object>

VerticalScrollOffset

Возвращает величину смещения полосы вертикальной прокрутки таблицы в пикселях.

<Object Name="TimeTableName">
  <Property Name="VerticalScrollOffset" />
</Object>

HorizontalScrollOffset

Возвращает величину смещения полосы горизонтальной прокрутки таблицы в пикселях.

<Object Name="TimeTableName">
  <Property Name="HorizontalScrollOffset" />
</Object>

ColumnWidth

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

<Object Name="TimeTableName">
  <Property Name="ColumnWidth" />
</Object>

ColumnAlignment

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

<Object Name="TimeTableName">
  <Property Name="ColumnAlignment" />
</Object>

ColumnHeaderAlignment

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

<Object Name="TimeTableName">
  <Property Name="ColumnHeaderAlignment" />
</Object>

DateStart

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

<Object Name="TimeTableName">
  <Property Name="DateStart" />
</Object>

DateFinish

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

<Object Name="TimeTableName">
  <Property Name="DateFinish" />
</Object>

IntervalType

Возвращает название типа единиц измерения интервала столбца.

<Object Name="TimeTableName">
  <Property Name="IntervalType" />
</Object>

IntervalValue

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

<Object Name="TimeTableName">
  <Property Name="IntervalValue" />
</Object>

IntervalTitleFormat

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

<Object Name="TimeTableName">
  <Property Name="IntervalTitleFormat" />
</Object>

MultiSelect

Возвращает признак, определяющий, может ли пользователь выделять ячейки одновременно для нескольких элементов (в нескольких строках таблицы).

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

SelectedDateStart

Возвращает дату, соответствующую началу самой левой среди выделенных ячеек таблицы.

<Object Name="TimeTableName">
  <Property Name="SelectedDateStart" />
</Object>

SelectedDateFinish

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

<Object Name="TimeTableName">
  <Property Name="SelectedDateFinish" />
</Object>

SelectedItemsCount

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

<Object Name="TimeTableName">
  <Property Name="SelectedItemsCount" />
</Object>

SelectedItemId

Возвращает идентификатор одного из выделенных элементов таблицы (элемент считается выделенным, если выделена хотя бы одна ячейка в строке, соответствующей этому элементу).

<Object Name="TimeTableName">
  <Property Name="SelectedItemId" />
</Object>

SelectedItemIds

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

<Object Name="TimeTableName">
  <Property Name="SelectedItemIds" />
</Object>

SelectedIntervalsCount

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

<Object Name="TimeTableName">
  <Property Name="SelectedIntervalsCount" />
</Object>

SelectedIntervalId

Возвращает идентификатор одного из выделенных интервалов времени (интервал времени считается выделенным, если выделена хотя бы одна ячейка, в которую он попадает).

<Object Name="TimeTableName">
  <Property Name="SelectedIntervalId" />
</Object>

SelectedIntervalIds

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

<Object Name="TimeTableName">
  <Property Name="SelectedIntervalIds" />
</Object>

SelectedCellsFilled

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

<Object Name="TimeTableName">
  <Property Name="SelectedCellsFilled" />
</Object>

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

RowHeight

Задает высоту строк с данными в таблице.

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

<Object Name="TimeTableName">
  <Property Name="RowHeight">20</Property>
</Object>

ColumnHeadersHeight

Задает высоту "шапки" таблицы.

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

<Object Name="TimeTableName">
  <Property Name="ColumnHeadersHeight">20</Property>
</Object>

ColumnHeadersVisible

Задает признак, определяющий, показывать или нет "шапку" таблицы.

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

<Object Name="TimeTableName">
  <Property Name="ColumnHeadersVisible">True</Property>
</Object>

RowHeadersWidth

Задает ширину "нулевого" столбца таблицы, где расположены названия элементов.

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

<Object Name="TimeTableName">
  <Property Name="RowHeadersWidth">200</Property>
</Object>

RowHeadersVisible

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

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

<Object Name="TimeTableName">
  <Property Name="RowHeadersVisible">False</Property>
</Object>

BackgroundColor

Задает имя цвета фона таблицы.

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

<Object Name="TimeTableName">
  <Property Name="BackgroundColor">BackgroundColor</Property>
</Object>

BorderStyle

Задает название типа границ таблицы.

Ожидается название одного из типов границ таблицы.

<Object Name="TimeTableName">
  <Property Name="BorderStyle">Fixed3D</Property>
</Object>

CellBorderStyle

Задает название стиля границ ячеек в таблице.

Ожидается название одного из стилей границ ячеек в таблице.

<Object Name="TimeTableName">
  <Property Name="CellBorderStyle">SingleHorizontal</Property>
</Object>

AutoSizeRowsMode

Задает название типа автоматического изменения высот строк таблицы.

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

<Object Name="TimeTableName">
  <Property Name="AutoSizeRowsMode">AllCells</Property>
</Object>

AutoSize

Единоразово устанавливает ширину и высоту таблицы, сворачивая или разворачивая её таким образом, чтобы в зоне видимости оказались все её строки и столбцы без полос прокрутки.

Значение тэга <Property>: не ожидается.

<Object Name="TimeTableName"
  <Property Name="AutoSize" />
</Object>

DateStart

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

Ожидается значение даты/времени.

<Object Name="TimeTableName">
  <Property Name="DateStart">01.06.2014</Property>
</Object>

DateFinish

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

Ожидается значение даты/времени.

<Object Name="TimeTableName">
  <Property Name="DateFinish">01.07.2014</Property>
</Object>

MultiSelect

Задает признак, определяющий, может ли пользователь выделять ячейки одновременно для нескольких элементов (в нескольких строках таблицы).

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

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