ChangeTextBoxRelativeSizeCommand.execute(settings) Method

Executes the ChangeTextBoxRelativeSizeCommand command by applying the specified setting.

May result in taking no action if the command’s state does not allow command execution. Use the object’s getState method to check the command state.

Declaration

execute(
    settings: TextBoxRelativeSizeSettings
): boolean

Parameters

Name	Type	Description
settings	TextBoxRelativeSizeSettings	A TextBoxRelativeSizeSettings object specifying relative size settings.

Returns

Type	Description
boolean	A Boolean value identifying whether method execution was successful or failed.

Remarks

The execute method checks the command state (obtained using the getState method) before executing, and decides 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 (it is implied that selection is set to a floating object):

JS

var settings = {
    relativeWidth: rich.unitConverter.pixelsToTwips(50),
    relativeWidthType: ASPx.FloatingObjectRelativeWidthType.Page,
    relativeHeight: rich.unitConverter.pixelsToTwips(25),
    relativeHeightType: ASPx.FloatingObjectRelativeHeightType.Page
};
rich.commands.changeTextBoxRelativeSize.execute(settings);