RichEditCommands.changeTableCellPreferredWidth Property

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

Declaration

get changeTableCellPreferredWidth(): ChangeTableCellPreferredWidthCommand

Property Value

Type	Description
ChangeTableCellPreferredWidthCommand

An object that provides methods that execute the command and check its state.

Remarks

Call the execute(preferredWidth) method to invoke the command. The method checks the command state (obtained via the getState method) to determine whether the action can be performed.

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:

javascript

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.

javascript

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);

Refer to the following section for more information: Client Commands.