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>
<RowHeight>
Value
Значение.
Обязательный атрибут. Ожидается целочисленное значение.
ColumnHeadersHeight
Высота "шапки" таблицы.
Необязательный тэг. Значение тэга <ColumnHeadersHeight>
: не ожидается.
Если тэг <ColumnHeadersHeight>
отсутствует, то для атрибута Value
используется стандартное значение .NET.
<ColumnHeadersHeight Value="21" />
Атрибуты тэга <ColumnHeadersHeight>
<ColumnHeadersHeight>
Value
Значение.
Обязательный атрибут. Ожидается целочисленное значение.
ColumnHeadersVisible
Признак, определяющий, показывать или нет "шапку" таблицы.
Необязательный тэг. Значение тэга <ColumnHeadersVisible>
: не ожидается.
Если тэг <ColumnHeadersVisible>
отсутствует, то для атрибута Value
используется значение True.
<ColumnHeadersVisible Value="True" />
Атрибуты тэга <ColumnHeadersVisible>
<ColumnHeadersVisible>
Value
Значение.
Обязательный атрибут. Ожидается логическое значение.
RowHeadersWidth
Ширина "нулевого" столбца таблицы, где расположены названия элементов.
Необязательный тэг. Значение тэга <RowHeadersWidth>
: не ожидается.
Если тэг <RowHeadersWidth>
отсутствует, то для атрибута Value
используется значение 100.
<RowHeadersWidth Value="40" />
Атрибуты тэга <RowHeadersWidth>
<RowHeadersWidth>
Value
Значение.
Обязательный атрибут. Ожидается целочисленное значение.
RowHeadersVisible
Признак, определяющий, показывать или нет "нулевой" столбец таблицы, где расположены названия элементов.
Необязательный тэг. Значение тэга <RowHeadersVisible>
: не ожидается.
Если тэг <RowHeadersVisible>
отсутствует, то для атрибута Value
используется значение True.
<RowHeadersVisible Value="True" />
Атрибуты тэга <RowHeadersVisible>
<RowHeadersVisible>
Value
Значение.
Обязательный атрибут. Ожидается логическое значение.
BackgroundColor
Цвет фона таблицы.
Необязательный тэг. Значение тэга <BackgroundColor>
: не ожидается.
Если тэг <BackgroundColor>
отсутствует, то для атрибута Value
используется стандартное значение .NET.
<BackgroundColor Value="BackgroundColor" />
Атрибуты тэга <BackgroundColor>
<BackgroundColor>
Value
Значение.
Обязательный атрибут. Ожидается имя одного из цветов, описанных на форме или описание цвета в формате HTML (#rrggbb).
BorderStyle
Название типа границ таблицы.
Необязательный тэг. Значение тэга <BorderStyle>
: не ожидается.
Если тэг <BorderStyle>
отсутствует, то для атрибута Value
используется значение FixedSingle.
<BorderStyle Value="FixedSingle" />
Атрибуты тэга <BorderStyle>
<BorderStyle>
Value
Значение.
Обязательный атрибут. Ожидается название одного из типов границ таблицы.
Типы границ таблицы
None
Нет границ
FixedSingle
Одиночная плоская
Fixed3D
Одиночная объемная
CellBorderStyle
Название стиля границ ячеек в таблице.
Необязательный тэг. Значение тэга <CellBorderStyle>
: не ожидается.
Если тэг <CellBorderStyle>
отсутствует, то для атрибута Value
используется значение Single.
<CellBorderStyle Value="Single" />
Атрибуты тэга <CellBorderStyle>
<CellBorderStyle>
Value
Значение.
Обязательный атрибут. Ожидается название одного из стилей границ ячеек в таблице.
Стили границ ячеек
Custom
Граница, которая была настроена
Single
Одинарная граница
Raised
Трехмерная выпуклая граница
Sunken
Трехмерная утопленная граница
None
Отсутствие границ
SingleVertical
Вертикальная одинарная граница
RaisedVertical
Вертикальная трехмерная выпуклая граница
SunkenVertical
Вертикальная трехмерная утопленная граница
SingleHorizontal
Горизонтальная одинарная граница
RaisedHorizontal
Горизонтальная трехмерная выпуклая граница
SunkenHorizontal
Горизонтальная трехмерная утопленная граница
AutoSizeRowsMode
Название типа автоматического изменения высоты строк таблицы.
Необязательный тэг. Значение тэга <AutoSizeRowsMode>
: не ожидается.
Если тэг <AutoSizeRowsMode>
отсутствует, то для атрибута Value
используется значение None.
<AutoSizeRowsMode Value="None" />
Атрибуты тэга <AutoSizeRowsMode>
<AutoSizeRowsMode>
Value
Значение.
Обязательный атрибут. Ожидается название одного из типов автоматического изменения высоты строк таблицы.
Типы автоматического изменения высоты строк таблицы
None
Нет автоматического изменения высоты строк таблицы
AllCells
Высота строк изменяется в соответствии с содержимым всех ячеек в строках, включая ячейки заголовка
AllCellsExceptHeaders
Высота строк изменяется в соответствии с содержимым всех ячеек в строках, исключая ячейки заголовка
AllHeaders
Высота строк изменяется в соответствии с содержимым заголовка строк
DisplayedCells
Высота строк изменяется в соответствии с содержимым всех ячеек в строках, отображаемых в текущий момент на экране, включая ячейки заголовка
DisplayedCellsExceptHeaders
Высота строк изменяется в соответствии с содержимым всех ячеек в строках, отображаемых в текущий момент на экране, исключая ячейки заголовка
DisplayedHeaders
Высота строк изменяется в соответствии с содержимым заголовков строк, отображаемых в текущий момент на экране
ValueSeparator
Текстовый разделитель для нескольких значений в одной ячейке таблицы.
Необязательный тэг. Значение тэга <ValueSeparator>
: не ожидается.
Если тэг <ValueSeparator>
отсутствует, то для атрибута Value
используется значение " ".
Поддерживается символ "\r", который интерпретируется как перенос на новую строку.
<ValueSeparator Value="\r" />
Атрибуты тэга <ValueSeparator>
<ValueSeparator>
Value
Значение.
Обязательный атрибут. Любое значение будет переведено в текстовое.
ColumnWidth
Ширина столбцов таблицы.
Необязательный тэг. Значение тэга <ColumnWidth>
: не ожидается.
Если тэг <ColumnWidth>
отсутствует, то для атрибута Value
используется значение 50.
<ColumnWidth Value="50" />
Атрибуты тэга <ColumnWidth>
<ColumnWidth>
Value
Значение.
Обязательный атрибут. Ожидается положительное целочисленное значение.
ColumnAlignment
Название типа положения содержимого ячеек столбцов.
Необязательный тэг. Значение тэга <ColumnAlignment>
: не ожидается.
Если тэг <ColumnAlignment>
отсутствует, то для атрибута Value
используется значение NotSet.
<ColumnAlignment Value="NotSet" />
Атрибуты тэга <ColumnAlignment>
<ColumnAlignment>
Value
Значение.
Обязательный атрибут. Ожидается название одного из типов положения содержимого ячейки столбца.
Типы положения содержимого ячейки столбца
NotSet
Не установлено
TopLeft
Содержимое выравнивается по верхнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении
TopCenter
Содержимое выравнивается по верхнему краю в вертикальном направлении и по центру ячейки
TopRight
Содержимое выравнивается по верхнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении
MiddleLeft
Содержимое выравнивается вертикально по середине и горизонтально по левому краю ячейки в горизонтальном направлении
MiddleCenter
Содержимое выравнивается по вертикальному и горизонтальному центру ячейки
MiddleRight
Содержимое выравнивается вертикально по середине и горизонтально по правому краю ячейки в горизонтальном направлении
BottomLeft
Содержимое выравнивается по нижнему краю в вертикальном направлении и по левому краю ячейки в горизонтальном направлении
BottomCenter
Содержимое выравнивается по нижнему краю в вертикальном направлении и по центру ячейки
BottomRight
Содержимое выравнивается по нижнему краю в вертикальном направлении и по правому краю ячейки в горизонтальном направлении
ColumnHeaderAlignment
Название типа положения содержимого заголовков столбцов.
Необязательный тэг. Значение тэга <ColumnHeaderAlignment>
: не ожидается.
Если тэг <ColumnHeaderAlignment>
отсутствует, то для атрибута Value
используется значение NotSet.
<ColumnHeaderAlignment Value="NotSet" />
Атрибуты тэга <ColumnHeaderAlignment>
<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>
<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>
Last updated