RichEditCommands.changeTableCellPreferredWidth Property

Gets a command to change the preferred cell width of the selected table rows.

Declaration

changeTableCellPreferredWidth: ChangeTableCellPreferredWidthCommand

Property Value

Type	Description
ChangeTableCellPreferredWidthCommand	A ChangeTableCellPreferredWidthCommand object that provides methods for executing the command and checking its state.

Remarks

You can invoke this command by calling the execute method.

The execute method checks the command state (obtained using the getState method) before executing, and decides whether the action can be performed. The execute and getState methods are members of the ChangeTableCellPreferredWidthCommand class.

The command includes size parameters assigned in twips. Use the ASPxClientRichEdit.unitConverter to convert size measure units (inches, points, pixels, centimeters) to twips.

Usage example:

JS

var cellWidthSettings = {type: ASPx.TableWidthUnitType.ModelUnits, value: richEdit.unitConverter.pixelsToTwips(75)};
richEdit.commands.changeTableCellPreferredWidth.execute(cellWidthSettings);

The preferredWidth parameter allows you to specify a width value of selected table cells. The parameter is applied when the preferredWidth value of the whole table is cleared. The following code snippet demonstrates how to disable the width settings of the whole table and define the preferredWidth value for the selected table cells.

JS

var tableSettings = {preferredWidth: {type: ASPx.TableWidthUnitType.Nil, value: 0}, resizeToFitContent: false};
richEdit.commands.changeTableFormatting.execute(tableSettings);

var cellWidthSettings = {type: ASPx.TableWidthUnitType.ModelUnits, value: richEdit.unitConverter.pixelsToTwips(75)};
richEdit.commands.changeTableCellPreferredWidth.execute(cellWidthSettings);