DateRangePicker

#DateRangePicker

An object used to specify a date or time range. Used to specify a range value in the start and end date logic.

While the active screen is a form in the authoring interface, the Toolbox panel lists form objects. The object is added to the form by drag/drop from the toolbox panel.

Clicking on the object displays the "General" and "Events" tabs in the Property Viewer panel, and the properties of the object can be viewed and edited. The inheritance scheme by which the properties of the object are transferred is as follows;

General

Design

'Name' - The name of the object to be used by the system. Inside another object and on the code side, the object is accessed by the value written in the namespace.

Start Date

The 'Allow empty' field determines whether the start date field can be left blank. When this feature is enabled, the start date field can be left blank. When the feature is passive, a value is required to be selected as the start date.

'Set today as default' - When the feature is activated, today's date is shown as the default selected in the start date field.

'Disabled hours' - When the Show Time property in the object properties is active, the clocks specified in this field appear passively in the object and cannot be selected.

If it is not desirable to select a specific time range, the corresponding time range is typed with a "–" between the time values. For example; If it is not desirable to select hours between 12 and 16 o'clock, the value "12-16" is written in this field. In the time selection area of the object, these time intervals appear passive.

If it is desired that multiple time values cannot be selected, this field is written by placing a "," between these time values. For example; If it is desired that the hours 01,03 and 05 cannot be selected, the phrase "01,03,05" should be written in this field.

'Disabled minutes' - When the Show Time property in the object properties is active, the minutes specified in this field appear passively in the object and cannot be selected.

If it is not desirable to select a specific minute interval, the corresponding minute interval is typed with a "–" between the minute values. For example; If you want to be passive for 20 to 25 minutes, the value "20-25" is written in this field. In the object in the minute selection area, these minute intervals appear passive.

If it is desired that multiple minute values cannot be selected, this is written in this field by placing "," between these minute values. For example; If it is desired that minutes 40 and 45 cannot be selected, the phrase "40,45" should be written in this field.

'Disabled seconds' - When the Show Time property in the object properties is enabled, the default format in the Format field is "YYYY-MM-DD HH:mm". If the second value is also required to be selected in the object, this format should be set to YYYY-MM-DD HH:mm:ss. After this edit, the second value is also viewable in the object.

The seconds specified in the Disabled Seconds field appear passively in the object and cannot be selected.

If it is not desirable to select a specific second interval, the corresponding second interval is written with a "–" between the seconds values. For example; If you want to be passive between 03 and 07 seconds, the value "03-07" is written in this field. In the second selection area of the object, these second intervals appear passive.

If it is desired that multiple seconds cannot be selected, this is written in this field by placing "," between these second values. For example; If it is desired that the seconds 53, 55 and 56 cannot be selected, then "53,55,56" should be written in this field.

'Value' - The value of the start date field is expressed here. The date selected in this field appears in the object as the default value of the start date field.

'Placeholder' - A property used to display the data information requested to be entered by the end user into the object for informational purposes within the object. When the end user views the object, they see the referring text typed in this field, and the router text disappears when they focus on the object and begin entering values.

End Date

This field determines whether the 'Allow empty' field can be left blank. When this feature is enabled, the end date field can be left blank. When the feature is passive, a value is required to be selected as the end date.

'Set today as default' - When the feature is activated, today's date appears as the default selected in the end date field.

'Disabled hours' - When the Show Time property in the object properties is active, the clocks specified in this field appear passively in the object and cannot be selected.

If it is not desirable to select a specific time range, the corresponding time range is typed with a "–" between the time values. For example; If it is not desirable to select hours between 12 and 16 o'clock, the value "12-16" is written in this field. In the time selection area of the object, these time intervals appear passive.

If it is desired that multiple time values cannot be selected, this field is written by placing a "," between these time values. For example; If it is desired that the hours 01,03 and 05 cannot be selected, the phrase "01,03,05" should be written in this field.

'Disabled minutes' - When the Show Time property in the object properties is active, the minutes specified in this field appear passively in the object and cannot be selected.

If it is not desirable to select a specific minute interval, the corresponding minute interval is typed with a "–" between the minute values. For example; If you want to be passive for 20 to 25 minutes, the value "20-25" is written in this field. In the object in the minute selection area, these minute intervals appear passive.

If it is desired that multiple minute values cannot be selected, this is written in this field by placing "," between these minute values. For example; If it is desired that minutes 40 and 45 cannot be selected, the phrase "40,45" should be written in this field.

'Disabled seconds' - When the Show Time property in the object properties is enabled, the default format in the Format field is "YYYY-MM-DD HH:mm". If the second value is also required to be selected in the object, this format should be set to YYYY-MM-DD HH:mm:ss. After this edit, the second value is also viewable in the object.

The seconds specified in the Disabled Seconds field appear passively in the object and cannot be selected.

If it is not desirable to select a specific second interval, the corresponding second interval is written with a "–" between the seconds values. For example; If you want to be passive between 03 and 07 seconds, the value "03-07" is written in this field. In the second selection area of the object, these second intervals appear passive.

If it is desired that multiple seconds cannot be selected, this is written in this field by placing "," between these second values. For example; If it is desired that the seconds 53, 55 and 56 cannot be selected, then "53,55,56" should be written in this field.

'Value' - The value of the end date field is expressed here. The date selected in this field appears in the object as the default value of the end date field.

'Placeholder' - A property used to display the data information requested to be entered by the end user into the object for informational purposes within the object. When the end user views the object, they see the referring text typed in this field, and the router text disappears when they focus on the object and begin entering values.

Caption

'Title' - The part where the label text of the object is edited.

'Position' - The part of the object label that regulates whether it is positioned on the left, right or above the object.

>Choices Available : Left, Right, Top, Bottom

'Width' - This is where the width of the label field is set.

'Height' - This is the part where the height of the label field is set.

'Font' - The part of the text in the label area where the font, font, font size and color are set.

'Ellipsis' - The portion where the label text is set to appear for the part of the text that does not fit, whether the ellipsis (...) appears.

'Visible' - The part where the label field is set to be hidden or visible.

'Show Colon' - Colon next to label text (:) is the part where the expression is set to appear or not.

'Horizontal Align' - Label text; This is the portion where right-just, left-just, or center-justify settings are performed.

>Choices Can Be Made: Left, Center, Right

'Vertical Align' - Label text; This is the portion where the Justify, Snap Down, or Center settings are performed.

>Choices Available : Top, Middle, Bottom

'Mark Char' - To make the object stand out, enter *, ! is the area where characters such as can be entered.

'Mark Position' - The part where the character designated as the mark character is set to be shown at the beginning or end of the label text.

>Choices Can Be Made: AtFirst, AtLast

Appearance

'Visible' - This is the part where the object is hidden and made visible. When this field is active, the object is visible on the form. When the field is made passive, the object becomes invisible.

'Client Visible' - When the object is not visible when the form is first opened, when it is desired to make the object visible, to make the object visible when a certain condition is met, this field is made passive so that the object is invisible on the client side. When the condition set by the code or the Rules Manager is met, the object can be made visible again. When server visibility is inactive, the client cannot intervene, but the server can intervene when client visibility is inactive.

'Enabled' - The active mode of the object is set from this field. When this feature is active, data entry can be provided to the object and the object can be edited. When the feature is passive, the object is in non-editable mode and appears passive.

'Client Enabled' - When the form is first opened, the object is not active, when a certain condition is met, etc., this field is made inactive so that the object is not active on the client side. Once the condition set by the code or the Rules Manager is met, the object can be activated again. When server activity is inactive, the client cannot intervene, but the server can intervene when client activity is inactive.

'Background Color' - The area used to give the object a background color.

'Title' - Hovering over the object with the cursor while the form is open in the interface, the text typed in this field is shown as a hint. It is a feature used to direct the end user when detailed information about the object is desired.

'ClassName' - The field in which the object visibility can be changed by defining a class written in the CSS file of the form.

'TextAlign' - The field used to determine where to align the expression entered into the object. Left-align, center-align, right-align selections can be made.

>Choices Can Be Made: Left, Center, Right

'Size Type' - The area where the object size can be determined.

>Choices Can Be Made : Small, Middle, Large

Behavior

'ReadOnly' - This is where the object is set to be in edit mode. When this feature is enabled, the object does not allow data entry, it is in read-only mode. The property must be passive for data entry to be allowed into the object.

'Tab Index' - By entering numeric values in this field, it is determined in which order the tab button is pressed to focus between the form objects. When filling out the form, instead of clicking the cursor on the object where the data is to be entered, the tab button is pressed to focus directly on the indexed objects in a certain order. This is a feature that increases the speed of filling out forms.

'Required' - The field in which it is determined whether data entry is required on the object. When this feature is activated, it is not possible to advance/save the form without entering data into the object.

'Format' - This is the part where the date and time format that will appear in the Start and End Date fields is specified. When the Show Time property is disabled on the object, the default date format is "YYYY-MM-DD". When Show Time is enabled, the default format is "YYYY-MM-DD HH:mm". The format structure to be displayed in the object can be specified in this field.

'Mode' - A feature that is active when the Format field is left blank. Refers to the mode of the value to display in the object. In the start and end date fields of the object; It is used to ensure that selection is made based on only year, only month, only hour or only day.

>Possible Selections : Year, Month, Time, Date

'Show Time' - This feature must be activated for the time value to be displayed in the object. When the feature is enabled, the default value in the Format field is shown as "YYYY-MM-DD HH:mm".

'Show Today' - This feature is activated so that the 'Today' option appears on the date selection screen in the start and end date fields of the object. Clicking "Today" automatically reflects today's date on the object.

'Date limit type' - The area where the restriction type is specified when the restriction is desired to be made in the date range to be selected. According to the selection made, the fields that need to be selected in the object property will change.

>Choices Can Be Made: Active Date Types, Disabled Date Types

'Active date type' - The field that will be active when Active Date Types is selected in the Date limit type field. The determination of the selection range according to the item selection to be made in the field will be as follows.

• 'Range dates' - When selected, the Disabled date field becomes selectable in the object. According to the date range to be selected in Disabled date, date selection can be made in the object, other dates will not be selected.
• 'In year' - When selected, only a date from the current year can be selected. Previous or subsequent years will be unselectable.
• 'In month' - Once selected, a date can only be selected from within the current month. The previous or subsequent months become passive, that is, unselectable.
• 'In week' - Once selected, a date can only be selected from within the current week. The weeks before and after become passive, that is, unselectable.

'Disabled date type' - This is the field that will be active when Disabled Date Types is selected in the Date limit type field. The determination of the selection range according to the item selection to be made in the field will be as follows.

• 'Past disabled' - When selected, dates earlier than today appear in the object as unselectable.
• 'Before from date' - When selected, the Disabled date field on the object becomes selectable. Dates before the date to be selected in Disabled date will appear as unselectable in the object.
• 'After from date' - When selected, the Disabled date field becomes selectable on the object. Dates after the date to be selected in Disabled date will appear as unselectable in the object.
• 'Dynamic range' - When selected, the Disabled date range field in the object properties is active. The start date field is fixed from the current day to the day before or after the numeric value typed here. According to the start date selected from the available days, the interval is specified in the end date field because a day before the start date cannot be selected.

'Allow Clear' - If you want to be able to easily remove the selection made in the object, the feature should be activated.

Data Definition Language

'Field Name' - The field in the database of the system that determines the name of the column it will create for the object. In the "Name" section, the object can be given another name and the column name to be created for the object in the database table can be created as a different name.

'Allow Null' - This section indicates whether the database field to be created for the object will allow null values.

Events

The events owned by the object are located in the "Events" tab in the Property Viewer panel. Each event is triggered at different runtime moments, performing its own unique operations. Code written by the developer to these events is also executed at the time the corresponding event is triggered.

When the events in the "Client" field are double-clicked, the screen is directed to the form code editor section called "Formedi.ts" where TypeScript coding can be done and the method block for the clicked event is automatically created.

When the events in the "Server" field are double-clicked, the screen is directed to the form code editor section called "Formadı.cs" where C# coding can be done and the method block for the clicked event is automatically created.

The developer can construct any code block within these methods. Next to the event whose method is created on the code side by clicking from the Events tab, the method name information is automatically generated and the relationship between the event and the method is specified.