> For the complete documentation index, see [llms.txt](https://wfsys.gitbook.io/workflow-mobile-forms-syntax/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wfsys.gitbook.io/workflow-mobile-forms-syntax/workflow_mobile_forms/objects/calendar.md).

# Calendar

## Шаблон Calendar <a href="#template_panel" id="template_panel"></a>

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

```xml
<MyObject Name="" Type="Calendar" 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>
  <Opacity></Opacity>
  <Hint></Hint>
  <ContextMenu Name="" />
  <Change User="" Source="" ValueSet="" />
  <!--Тэги, специфичные для Calendar-->
  <DaysTitleHeight></DaysTitleHeight>
  <DayViewSize></DayViewSize>
  <TodayOutlineColor></TodayOutlineColor>
  <TodayFillColor></TodayFillColor>
  <EventIndicatorColor></EventIndicatorColor>
  <SelectedDateColor></SelectedDateColor>
  <SelectedDayBackgroundColor></SelectedDayBackgroundColor>
  <EventIndicatorSelectedColor></EventIndicatorSelectedColor>
  <SelectedDayTextColor></SelectedDayTextColor>
  <CalendarSectionShown></CalendarSectionShown>
  <EventList></EventList>
  <SelectedDate></SelectedDate>
  <Value></Value>
</MyObject>
```

## Описание Calendar <a href="#description_panel" id="description_panel"></a>

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

### Получение значения Calendar <a href="#get_value_label" id="get_value_label"></a>

Значением Calendar считается значение соответствующее выбранному дню.

```xml
<Object Name="CalendarName" />
```

### Задание значения Calendar <a href="#set_value_label" id="set_value_label"></a>

Ожидается значение типа дата.

```xml
<Object Name="CalendarName"></Object>
```

## Тэги, специфичные для Calendar <a href="#tags_panel" id="tags_panel"></a>

### DaysTitleHeight

Высота заголовка календаря.

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

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

```xml
<DaysTitleHeight>0</DaysTitleHeight>
```

### DayViewSize

Размер ячейки дня.

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

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

```xml
<DayViewSize>1</DayViewSize>
```

### TodayOutlineColor

Цвет границы ячейки дня, если он является текущим днем.

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

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

```xml
<TodayOutlineColor>ColorName</TodayOutlineColor>
```

### TodayFillColor

Цвет заливки ячейки дня, если он является текущим днем.

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

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

```xml
<TodayFillColor>ColorName</TodayFillColor>
```

### EventIndicatorColor

Цвет индикатора наличия событий.

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

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

```xml
<EventIndicatorColor>ColorName</EventIndicatorColor>
```

### SelectedDateColor

Цвет текста выбранного дня.

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

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

```xml
<SelectedDateColor>ColorName</SelectedDateColor>
```

### SelectedDayBackgroundColor

Цвет заливки ячейки дня при ее выборе.

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

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

```xml
<SelectedDayBackgroundColor>ColorName</SelectedDayBackgroundColor>
```

### EventIndicatorSelectedColor

Цвет индикатора наличия событий, если выбрана ячейка дня.

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

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

```xml
<EventIndicatorSelectedColor>ColorName</EventIndicatorSelectedColor>
```

### SelectedDayTextColor

Цвет текста в ячейке дня, если она выбрана.

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

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

```xml
<SelectedDayTextColor>ColorName</SelectedDayTextColor>
```

### CalendarSectionShown

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

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

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

```xml
<CalendarSectionShown>True</CalendarSectionShown>
```

### EventList

Элементы событий.

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

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

```xml
<EventList>
  <DataConnection SourceDataConnection="SourceDataConnectionName">
    <Fields>
      <Field Name="FieldDate" />
      <Field Name="FieldId" />
    </Fields>
  </DataConnection>
</EventList>
```

### SelectedDate <a href="#selected_date" id="selected_date"></a>

Выбранная дата.

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

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

```xml
<SelectedDate>2022-07-20</SelectedDate>
```

### Value <a href="#value" id="value"></a>

Значение соответствующее реальному значению объекта

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

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

```xml
<Value>1</Value>
```

## Get-проперти для получения свойств <a href="#get_property_panel" id="get_property_panel"></a>

### DaysTitleHeight <a href="#get_days_title_height" id="get_days_title_height"></a>

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

```xml
<Object Name="CalendarName">
  <Property Name="DaysTitleHeight" />
</Object>
```

### DayViewSize

Возвращает размер ячейки дня.

```xml
<Object Name="CalendarName">
  <Property Name="DayViewSize" />
</Object>
```

### TodayOutlineColor

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

```xml
<Object Name="CalendarName">
  <Property Name="TodayOutlineColor" />
</Object>
```

### TodayFillColor

Возвращает имя цвета заливки ячейки дня, если он является текущим днем, или описание цвета в формате HTML (#rrggbb).

```xml
<Object Name="CalendarName">
  <Property Name="TodayFillColor" />
</Object>
```

### EventIndicatorColor

Возвращает имя цвета индикатора наличия событий или описание цвета в формате HTML (#rrggbb).

```xml
<Object Name="CalendarName">
  <Property Name="EventIndicatorColor" />
</Object>
```

### SelectedDateColor

Возвращает имя цвета текста выбранного дня или описание цвета в формате HTML (#rrggbb).

```xml
<Object Name="CalendarName">
  <Property Name="SelectedDateColor" />
</Object>
```

### SelectedDayBackgroundColor

Возвращает имя цвета заливки ячейки дня при ее выборе или описание цвета в формате HTML (#rrggbb).

```xml
<Object Name="CalendarName">
  <Property Name="SelectedDayBackgroundColor" />
</Object>
```

### EventIndicatorSelectedColor

Возвращает имя цвета индикатора наличия событий, если выбрана ячейка дня, или описание цвета в формате HTML (#rrggbb).

```xml
<Object Name="CalendarName">
  <Property Name="EventIndicatorSelectedColor" />
</Object>
```

### SelectedDayTextColor

Возвращает имя цвета текста в ячейки дне, если она выбрана, или описание цвета в формате HTML (#rrggbb).

```xml
<Object Name="CalendarName">
  <Property Name="SelectedDayTextColor" />
</Object>
```

### CalendarSectionShown

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

```xml
<Object Name="CalendarName">
  <Property Name="CalendarSectionShown" />
</Object>
```

### SelectedDate <a href="#get_selected_date" id="get_selected_date"></a>

Возвращает значение выбранной даты.

```xml
<Object Name="CalendarName">
  <Property Name="SelectedDate" />
</Object>
```

### MonthYear <a href="#get_month_year" id="get_month_year"></a>

Возвращает отображаемый месяц и год.

```xml
<Object Name="CalendarName">
  <Property Name="MonthYear" />
</Object>
```

## Set-проперти для динамического задания свойств <a href="#set_property_panel" id="set_property_panel"></a>

### DaysTitleHeight <a href="#set_days_title_height" id="set_days_title_height"></a>

Задает высоту заголовка календаря.

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

```xml
<Object Name="CalendarName">
  <Property Name="DaysTitleHeight" />
</Object>
```

### DayViewSize

Задает размер ячейки дня.

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

```xml
<Object Name="CalendarName">
  <Property Name="DayViewSize" />
</Object>
```

### TodayOutlineColor

Задает имя цвета границы ячейки дня, если он является текущим днем.

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

```xml
<Object Name="CalendarName">
  <Property Name="TodayOutlineColor" />
</Object>
```

### EventIndicatorColor

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

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

```xml
<Object Name="CalendarName">
  <Property Name="EventIndicatorColor" />
</Object>
```

### EventIndicatorSelectedColor

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

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

```xml
<Object Name="CalendarName">
  <Property Name="EventIndicatorSelectedColor" />
</Object>
```

### TodayFillColor

Задает имя цвета заливки ячейки дня, если он является текущим днем.

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

```xml
<Object Name="CalendarName">
  <Property Name="TodayFillColor" />
</Object>
```

### SelectedDateColor <a href="#set_selected_date_color" id="set_selected_date_color"></a>

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

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

```xml
<Object Name="CalendarName">
  <Property Name="SelectedDateColor" />
</Object>
```

### SelectedDayTextColor <a href="#set_selected_date_text_color" id="set_selected_date_text_color"></a>

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

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

```xml
<Object Name="CalendarName">
  <Property Name="SelectedDayTextColor" />
</Object>
```

### SelectedDayBackgroundColor <a href="#set_selected_date_background_color" id="set_selected_date_background_color"></a>

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

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

```xml
<Object Name="CalendarName">
  <Property Name="SelectedDayBackgroundColor" />
</Object>
```

### CalendarSectionShown <a href="#set_calendar_section_shown" id="set_calendar_section_shown"></a>

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

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

```xml
<Object Name="CalendarName">
  <Property Name="CalendarSectionShown" />
</Object>
```