FloatingShapeBase
Abstract base for all floating shape elements positioned over worksheet cells with anchoring, providing shared identity, naming, and geometry management.
Definition
Namespace:Telerik.Windows.Documents.Spreadsheet.Model.Shapes
Assembly:Telerik.Windows.Documents.Spreadsheet.dll
Syntax:
public abstract class FloatingShapeBaseInheritance: objectFloatingShapeBase
Derived Classes:
Events
Raised when any shape property changes, signaling that dependent UI or layout should refresh.
public event EventHandler ShapeChangedMethods
Raises the ShapeChanged event, notifying subscribers of property modifications.
protected void OnShapeChanged()Resizes the shape to the specified height via command, optionally preserving aspect ratio and adjusting anchor position to maintain visual top-left corner.
public void SetHeight(bool respectLockAspectRatio, double height, bool adjustCellIndex = false)A value indicating whether the aspect ratio lock should be respected.
heightdoubleThe new height.
adjustCellIndexboolA value indicating whether the top cell index and offset of the image should be adjusted.
Resizes the shape to the specified width via command, optionally preserving aspect ratio and adjusting anchor position to maintain visual top-left corner.
public void SetWidth(bool respectLockAspectRatio, double width, bool adjustCellIndex = false)A value indicating whether the aspect ratio lock should be respected.
widthdoubleThe new width.
adjustCellIndexboolA value indicating whether the top cell index and offset of the image should be adjusted.
Properties
Text description for accessibility and metadata purposes; changes are executed via command for undo support.
public string Description { get; set; }The description of the shape.
Discriminates the shape category (Image, Chart, Note, Comment) to enable type-specific handling.
public abstract FloatingShapeType FloatingShapeType { get; }Unique identifier within the owning worksheet, assigned at creation and invariant during the shape's lifetime.
public int Id { get; }The id of the shape.
Controls whether resizing operations maintain the original width-to-height ratio, preventing distortion when set to true.
public bool LockAspectRatio { get; set; }The value indicating whether the aspect ratio between the width and height should remain constant.
User-assigned name for the shape, useful for identification and scripting; changes are executed via command for undo support.
public string Name { get; set; }The name of the shape.