Class sap.m.PlanningCalendarRowModule: sap/m/PlanningCalendarRow

extends Element

Row in the PlanningCalendar.

This element holds the data of one row in the PlanningCalendar. Once the header information (e.g. person information) is assigned, the appointments are assigned.


Since: 1.34.0.
Constructor Summary
new sap.m.PlanningCalendarRow(sId?, mSettings?)Constructor for a new PlanningCalendarRow.
Method Summary
sap.m.PlanningCalendarRow.extend(sClassName, oClassInfo?, FNMetaImpl?)Creates a new subclass of class sap.m.PlanningCalendarRow with name sClassName and enriches it with the information contained in oClassInfo.
sap.m.PlanningCalendarRow.getMetadata()Returns a metadata object for class sap.m.PlanningCalendarRow.
addAppointment(oAppointment)Adds some appointment to the aggregation appointments.
addIntervalHeader(oIntervalHeader)Adds some intervalHeader to the aggregation intervalHeaders.
destroyAppointments()Destroys all the appointments in the aggregation appointments.
destroyIntervalHeaders()Destroys all the intervalHeaders in the aggregation intervalHeaders.
getAppointments()Gets content of aggregation appointments.
getIcon()Gets current value of property icon.
getIntervalHeaders()Gets content of aggregation intervalHeaders.
getKey()Gets current value of property key.
getNonWorkingDays()Gets current value of property nonWorkingDays.
getNonWorkingHours()Gets current value of property nonWorkingHours.
getSelected()Gets current value of property selected.
getText()Gets current value of property text.
getTitle()Gets current value of property title.
indexOfAppointment(oAppointment)Checks for the provided sap.ui.unified.CalendarAppointment in the aggregation appointments.
indexOfIntervalHeader(oIntervalHeader)Checks for the provided sap.ui.unified.CalendarAppointment in the aggregation intervalHeaders.
insertAppointment(oAppointment, iIndex)Inserts a appointment into the aggregation appointments.
insertIntervalHeader(oIntervalHeader, iIndex)Inserts a intervalHeader into the aggregation intervalHeaders.
removeAllAppointments()Removes all the controls from the aggregation appointments.
removeAllIntervalHeaders()Removes all the controls from the aggregation intervalHeaders.
removeAppointment(vAppointment)Removes a appointment from the aggregation appointments.
removeIntervalHeader(vIntervalHeader)Removes a intervalHeader from the aggregation intervalHeaders.
setIcon(sIcon)Sets a new value for property icon.
setKey(sKey)Sets a new value for property key.
setNonWorkingDays(sNonWorkingDays)Sets a new value for property nonWorkingDays.
setNonWorkingHours(sNonWorkingHours)Sets a new value for property nonWorkingHours.
setSelected(bSelected)Sets a new value for property selected.
setText(sText)Sets a new value for property text.
setTitle(sTitle)Sets a new value for property title.
Constructor Detail
new sap.m.PlanningCalendarRow(sId?, mSettings?)
Constructor for a new PlanningCalendarRow.

Accepts an object literal mSettings that defines initial property values, aggregated and associated objects as well as event handlers. See sap.ui.base.ManagedObject for a general description of the syntax of the settings object.

The supported settings are:

In addition, all settings applicable to the base type sap.ui.core.Element can be used as well.

Parameters:
{string}sId? ID for the new control, generated automatically if no ID is given
{object}mSettings? Initial settings for the new control
Method Detail
sap.m.PlanningCalendarRow.extend(sClassName, oClassInfo?, FNMetaImpl?): function
Creates a new subclass of class sap.m.PlanningCalendarRow with name sClassName and enriches it with the information contained in oClassInfo.

oClassInfo might contain the same kind of information as described in sap.ui.core.Element.extend.

Parameters:
{string}sClassName Name of the class being created
{object}oClassInfo? Object literal with information about the class
{function}FNMetaImpl? Constructor function for the metadata object; if not given, it defaults to sap.ui.core.ElementMetadata
Returns:
{function} Created class / constructor function
sap.m.PlanningCalendarRow.getMetadata(): sap.ui.base.Metadata
Returns a metadata object for class sap.m.PlanningCalendarRow.
Returns:
{sap.ui.base.Metadata} Metadata object describing this class
addAppointment(oAppointment): sap.m.PlanningCalendarRow
Adds some appointment to the aggregation appointments.
Parameters:
{sap.ui.unified.CalendarAppointment}oAppointment the appointment to add; if empty, nothing is inserted
Returns:
{sap.m.PlanningCalendarRow} Reference to this in order to allow method chaining
addIntervalHeader(oIntervalHeader): sap.m.PlanningCalendarRow
Adds some intervalHeader to the aggregation intervalHeaders.
Parameters:
{sap.ui.unified.CalendarAppointment}oIntervalHeader the intervalHeader to add; if empty, nothing is inserted
Returns:
{sap.m.PlanningCalendarRow} Reference to this in order to allow method chaining
destroyAppointments(): sap.m.PlanningCalendarRow
Destroys all the appointments in the aggregation appointments.
Returns:
{sap.m.PlanningCalendarRow} Reference to this in order to allow method chaining
destroyIntervalHeaders(): sap.m.PlanningCalendarRow
Destroys all the intervalHeaders in the aggregation intervalHeaders.
Returns:
{sap.m.PlanningCalendarRow} Reference to this in order to allow method chaining
Gets content of aggregation appointments.

Appointments to be displayed in the row. Appointments outside the visible time frame are not rendered.

Note: For performance reasons only appointments in the visible time range or nearby should be assigned.

Returns:
{sap.ui.unified.CalendarAppointment[]}
getIcon(): sap.ui.core.URI
Gets current value of property icon.

Icon of the header (e.g. picture of the person)

URI of an image or an icon registered in sap.ui.core.IconPool.

Returns:
{sap.ui.core.URI} Value of property icon
getIntervalHeaders(): sap.ui.unified.CalendarAppointment[]
Gets content of aggregation intervalHeaders.

Appointments to be displayed in the top of the intervals. The intervalHeaders are used to visualize public holidays and similar things.

Appointments outside the visible time frame are not rendered.

The intervalHeaders always fill whole intervals. If they are shorter than one interval they are not displayed.

Note: For performance reasons only appointments in the visible time range or nearby should be assigned.

Returns:
{sap.ui.unified.CalendarAppointment[]}
getKey(): string
Gets current value of property key.

Can be used as an identifier of the row

Returns:
{string} Value of property key
getNonWorkingDays(): int[]
Gets current value of property nonWorkingDays.

If set, the provided weekdays are displayed as non-working days. Valid values inside the array are 0 to 6. (other values will just be ignored.)

If not set, the weekend defined in the locale settings is displayed as non-working days.

Note: The non-working days are only visualized if intervalType is set to day.

Returns:
{int[]} Value of property nonWorkingDays
getNonWorkingHours(): int[]
Gets current value of property nonWorkingHours.

If set, the provided hours are displayed as non-working hours. Valid values inside the array are 0 to 23. (other values will just be ignored.)

Note: The non-working hours are only visualized if intervalType is set to hour.

Returns:
{int[]} Value of property nonWorkingHours
getSelected(): boolean
Gets current value of property selected.

Defines the selected state of the PlanningCalendarRow. Note: Binding the selected property in single selection modes may cause unwanted results if you have more than one selected row in your binding.

Default value is false.

Returns:
{boolean} Value of property selected
getText(): string
Gets current value of property text.

Text of the header (e.g. department of the person)

Returns:
{string} Value of property text
getTitle(): string
Gets current value of property title.

Title of the header (e.g. name of the person)

Returns:
{string} Value of property title
indexOfAppointment(oAppointment): int
Checks for the provided sap.ui.unified.CalendarAppointment in the aggregation appointments. and returns its index if found or -1 otherwise.
Parameters:
{sap.ui.unified.CalendarAppointment}oAppointment The appointment whose index is looked for
Returns:
{int} The index of the provided control in the aggregation if found, or -1 otherwise
indexOfIntervalHeader(oIntervalHeader): int
Checks for the provided sap.ui.unified.CalendarAppointment in the aggregation intervalHeaders. and returns its index if found or -1 otherwise.
Parameters:
{sap.ui.unified.CalendarAppointment}oIntervalHeader The intervalHeader whose index is looked for
Returns:
{int} The index of the provided control in the aggregation if found, or -1 otherwise
insertAppointment(oAppointment, iIndex): sap.m.PlanningCalendarRow
Inserts a appointment into the aggregation appointments.
Parameters:
{sap.ui.unified.CalendarAppointment}oAppointment the appointment to insert; if empty, nothing is inserted
{int}iIndex the 0-based index the appointment should be inserted at; for a negative value of iIndex, the appointment is inserted at position 0; for a value greater than the current size of the aggregation, the appointment is inserted at the last position
Returns:
{sap.m.PlanningCalendarRow} Reference to this in order to allow method chaining
insertIntervalHeader(oIntervalHeader, iIndex): sap.m.PlanningCalendarRow
Inserts a intervalHeader into the aggregation intervalHeaders.
Parameters:
{sap.ui.unified.CalendarAppointment}oIntervalHeader the intervalHeader to insert; if empty, nothing is inserted
{int}iIndex the 0-based index the intervalHeader should be inserted at; for a negative value of iIndex, the intervalHeader is inserted at position 0; for a value greater than the current size of the aggregation, the intervalHeader is inserted at the last position
Returns:
{sap.m.PlanningCalendarRow} Reference to this in order to allow method chaining
removeAllAppointments(): sap.ui.unified.CalendarAppointment[]
Removes all the controls from the aggregation appointments.

Additionally, it unregisters them from the hosting UIArea.

Returns:
{sap.ui.unified.CalendarAppointment[]} An array of the removed elements (might be empty)
removeAllIntervalHeaders(): sap.ui.unified.CalendarAppointment[]
Removes all the controls from the aggregation intervalHeaders.

Additionally, it unregisters them from the hosting UIArea.

Returns:
{sap.ui.unified.CalendarAppointment[]} An array of the removed elements (might be empty)
removeAppointment(vAppointment): sap.ui.unified.CalendarAppointment
Removes a appointment from the aggregation appointments.
Parameters:
{int|string|sap.ui.unified.CalendarAppointment}vAppointment The appointmentto remove or its index or id
Returns:
{sap.ui.unified.CalendarAppointment} The removed appointment or null
removeIntervalHeader(vIntervalHeader): sap.ui.unified.CalendarAppointment
Removes a intervalHeader from the aggregation intervalHeaders.
Parameters:
{int|string|sap.ui.unified.CalendarAppointment}vIntervalHeader The intervalHeaderto remove or its index or id
Returns:
{sap.ui.unified.CalendarAppointment} The removed intervalHeader or null
setIcon(sIcon): sap.m.PlanningCalendarRow
Sets a new value for property icon.

Icon of the header (e.g. picture of the person)

URI of an image or an icon registered in sap.ui.core.IconPool.

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{sap.ui.core.URI}sIcon New value for property icon
Returns:
{sap.m.PlanningCalendarRow} Reference to this in order to allow method chaining
Sets a new value for property key.

Can be used as an identifier of the row

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{string}sKey New value for property key
Returns:
{sap.m.PlanningCalendarRow} Reference to this in order to allow method chaining
setNonWorkingDays(sNonWorkingDays): sap.m.PlanningCalendarRow
Sets a new value for property nonWorkingDays.

If set, the provided weekdays are displayed as non-working days. Valid values inside the array are 0 to 6. (other values will just be ignored.)

If not set, the weekend defined in the locale settings is displayed as non-working days.

Note: The non-working days are only visualized if intervalType is set to day.

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{int[]}sNonWorkingDays New value for property nonWorkingDays
Returns:
{sap.m.PlanningCalendarRow} Reference to this in order to allow method chaining
setNonWorkingHours(sNonWorkingHours): sap.m.PlanningCalendarRow
Sets a new value for property nonWorkingHours.

If set, the provided hours are displayed as non-working hours. Valid values inside the array are 0 to 23. (other values will just be ignored.)

Note: The non-working hours are only visualized if intervalType is set to hour.

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{int[]}sNonWorkingHours New value for property nonWorkingHours
Returns:
{sap.m.PlanningCalendarRow} Reference to this in order to allow method chaining
setSelected(bSelected): sap.m.PlanningCalendarRow
Sets a new value for property selected.

Defines the selected state of the PlanningCalendarRow. Note: Binding the selected property in single selection modes may cause unwanted results if you have more than one selected row in your binding.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is false.

Parameters:
{boolean}bSelected New value for property selected
Returns:
{sap.m.PlanningCalendarRow} Reference to this in order to allow method chaining
setText(sText): sap.m.PlanningCalendarRow
Sets a new value for property text.

Text of the header (e.g. department of the person)

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{string}sText New value for property text
Returns:
{sap.m.PlanningCalendarRow} Reference to this in order to allow method chaining
setTitle(sTitle): sap.m.PlanningCalendarRow
Sets a new value for property title.

Title of the header (e.g. name of the person)

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{string}sTitle New value for property title
Returns:
{sap.m.PlanningCalendarRow} Reference to this in order to allow method chaining