CellOptions

Definition for the cells.

Here you can define a specific property for each cell. In each definition a row and column index defines which cell is to be addressed.

You can define:

Background color (identical to Control Background Color)
Border color (identical to Control Border Color)
Background image (identical to Control Background Image)
Width of the background image (identical to Control Background Image Width)
Height of the background image (identical to Control Background Image Height)
Horizontal alignment of the background image (identical to Control Background Image)
Vertical alignment of the background image (identical to Control Background Image)
Border width (identical to Control Border Width)
Border style (identical to Control Border Style)
Inside distance (identical to Control background image inside distance) If a percentage value is specified here for the "top" and "bottom" values, the width of the cell is used as the basis (and not the height).

Engineering

You can change the cell settings with this dialog.

Items	List of all objects added
	Delete the selected object
	Change the object order (top = left)
	Add a new object

Category: Colors

Name	Description
BackgroundColor	Definition of the background color
BorderColor	Definition of the border color of the control
BorderColor	Definition of the border color of the control
BorderRadius	Definition of the radius of the four corners to round them off
BorderStyle	Selection of the border style of the four sides of the control
BorderWidth	Definition of the border width of the four sides of the control

Category: Background Image

Name	Description
BackgroundImage	Definition of an image that is located above the background color
BackgroundImageHeight	Definition of the height of the background image
BackgroundImageHeightUnit	Selection of the unit of the height of the background image: Pixels for an absolute height Percent for a relative height
BackgroundImageWidth	Definition of the width of the background image
BackgroundImageWidthUnit	Selection of the unit of the width of the background image: Pixels for an absolute width Percent for a relative width
BackgroundImagePadding	Definition of an additional distance between the border of the control and background image for the four sides
BackgroundImageVerticalAlignment	Definition of the vertical alignment of the background image within the control
BackgroundImageHorizontalAlignment	Definition of the horizontal alignment of the background image within the control
BackgroundImageWidth	Definition of the width of the background image
BackgroundImageWidthUnit	Selection of the unit of the width of the background image: Pixels for an absolute width Percent for a relative width
BackgroundImageHeight	Definition of the height of the background image
BackgroundImageHeightUnit	Selection of the unit of the height of the background image: Pixels for an absolute height Percent for a relative height
BackgroundImageHorizontalAlignment	Definition of the horizontal alignment of the background image within the control
BackgroundImageVerticalAlignment	Definition of the vertical alignment of the background image within the control
BackgroundImagePadding	Definition of an additional distance between the border of the control and background image for the four sides

Category: Border

Name	Description
Border Width	Definition of the border width of the four sides of the cell
Border Style	Selection of the border style of the four sides of the cell

Category: Layout

Name	Description
Grid Column Index	Definition of the column of a grid that is to be defined by the cell option
Grid Row Index	Definition of the row of a grid that is to be defined by the cell option
Padding	Definition of an additional distance between the cell border and the controls added to the cell for the four sides

Schema (version 1.8): tchmi:framework#/definitions/CellOptions

Schema (version 1.12): tchmi:framework#/definitions/TcHmi.Controls.System.TcHmiGrid.CellOptions

Attribute getter

public getCellOptions(): TcHmi.Controls.System.TcHmiGrid.ICellOptions[] | undefined;

Parameter

Name	Type	Description
-	-	-

Return value

Type	Description
TcHmi.Controls.System.TcHmiGrid.ICellOptions[], undefined	The current value of the attribute.

Attribute setter

public setCellOptions(valueNew: TcHmi.Controls.System.TcHmiGrid.ICellOptions[] | null): void;

Parameter

Name	Type	Description
valueNew	TcHmi.Controls.System.TcHmiGrid.ICellOptions[], null	The new value of the attribute. If null is passed, the internal default value is used.

Return value

Type	Description
void	No return value.

	Available from 1.8