New to Telerik UI for WinForms? Start a free 30-day trial

Measures and arranges a table cell's block content within cell padding, vertical alignment, and pagination constraints.

Definition

Namespace:Telerik.WinForms.Documents.Layout

Assembly:Telerik.WinControls.RichTextEditor.dll

Syntax:

C#
public class TableCellLayoutBox : FlowOrderedLayoutBox, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor

Inheritance: objectDisposableObjectRadObjectLayoutElementLayoutBoxFlowOrderedLayoutBoxTableCellLayoutBox...

Implements: ICustomTypeDescriptorIDisposableINotifyPropertyChanged

Inherited Members FlowOrderedLayoutBox.Unlink()FlowOrderedLayoutBox.LinkAfter(FlowOrderedLayoutBox)FlowOrderedLayoutBox.Pair(FlowOrderedLayoutBox, FlowOrderedLayoutBox)FlowOrderedLayoutBox.PreviousBoxFlowOrderedLayoutBox.NextBoxFlowOrderedLayoutBox.PreviousAssociatedBoxFlowOrderedLayoutBox.NextAssociatedBoxFlowOrderedLayoutBox.IsLastBoxLayoutBox.currentYLayoutBox.AssociatedLayoutBoxPropertyLayoutBox.NodeLayoutBox.GetAssociatedLayoutBox(UIElement)LayoutBox.SetAssociatedLayoutBox(UIElement, LayoutBox)LayoutBox.OnElementStructureChanging()LayoutBox.OnElementStructureChanged()LayoutBox.OnAssociateDocumentElementChanged()LayoutBox.CreateChildrenCollection(DocumentStructureCollection)LayoutBox.ToString()LayoutBox.InvalidateMeasureUpToTheRoot()LayoutBox.InvalidateMeasureUpToTheRootStable()LayoutBox.InvalidateArrangeUpToTheRoot()LayoutBox.InvalidateLayoutAfterEdit()LayoutBox.ValidateChild(LayoutBox)LayoutBox.GetRootDocument()LayoutBox.CanGrowVertically(float)LayoutBox.GetBoxDesiredGrow()LayoutBox.CreateNewFragment(LayoutBox)LayoutBox.MergeWithNext(LayoutBox)LayoutBox.GetPositionHandler()LayoutBox.InvalidateMeasure()LayoutBox.IsRemovedLayoutBox.IsFragmentLayoutBox.AssociatedDocumentElementLayoutBox.ChildLayoutBoxesLayoutBox.IsFormattingSymbolLayoutBox.BoundsChildBoxesLayoutBox.IsFirstBoxLayoutBox.IsFirstChildLayoutBox.IsLastChildLayoutBox.IsValidPositionLayoutBox.ParentLayoutBox.ChildIndexLayoutBox.BoundingRectangleLayoutBox.CanCreateLayoutBoxesFromContentLayoutBox.IsContainerBoxLayoutBox.ElementStructureChangingLayoutBox.ElementStructureChangedLayoutElement.EnsureChildrenCreated()LayoutElement.CreateChildren()LayoutElement.OnBitStateChanged(DocumentElementStates, bool, bool)LayoutElement.SetBitState(DocumentElementStates, bool)LayoutElement.ValidateParent(LayoutElement)LayoutElement.SetParent(LayoutElement, LayoutElement)LayoutElement.SetParentCore(LayoutElement)LayoutElement.IsInValidState(bool)LayoutElement.OnInvalidateMeasure()LayoutElement.InvalidateMeasure(bool)LayoutElement.InvalidateArrange()LayoutElement.OnInvalidateArrange()LayoutElement.InvalidateArrange(bool)LayoutElement.Arrange(RectangleF)LayoutElement.ArrangeCore(RectangleF)LayoutElement.Measure(SizeF)LayoutElement.MeasureCore(SizeF)LayoutElement.OnChildDesiredSizeChanged(LayoutElement)LayoutElement.OnParentChanging()LayoutElement.OnParentChanged()LayoutElement.LayoutOffsetLayoutElement.LocalBoundingRectangleLayoutElement.ControlBoundingRectangleLayoutElement.ClippedControlBoundingRectangleLayoutElement.TotalTransformLayoutElement.ChildrenLayoutElement.BitStateLayoutElement.DesiredSizeLayoutElement.IsMeasureInProgressLayoutElement.BypassLayoutPoliciesLayoutElement.MeasureWithoutParentNotificationLayoutElement.SizeLayoutElement.IsArrangeValidLayoutElement.IsMeasureValidLayoutElement.TreeLevelLayoutElement.PreviousArrangeRectLayoutElement.AlignmentLayoutElement.AutoSizeLayoutElement.TransformLayoutElement.ParentChangingLayoutElement.ParentChangedRadObject.BindingContextPropertyRadObject.RadTypeRadObject.ReplaceDefaultDescriptors(PropertyDescriptorCollection)RadObject.DisposeManagedResources()RadObject.ClearPropertyStore()RadObject.SuspendPropertyNotifications()RadObject.ResumePropertyNotifications()RadObject.GetPropertyValue(RadProperty)RadObject.SetDefaultValueOverride(RadProperty, object)RadObject.GetValue(RadProperty)RadObject.SetValue(RadProperty, object)RadObject.ResetValue(RadProperty)RadObject.ResetLocalValue(RadProperty)RadObject.ResetValue(RadProperty, ValueResetFlags)RadObject.UpdateValue(RadProperty)RadObject.GetValueSource(RadProperty)RadObject.GetRegisteredRadProperty(string)RadObject.UpdateValueCore(RadPropertyValue)RadObject.SetValueCore(RadPropertyValue, object, object, ValueSource)RadObject.ResetValueCore(RadPropertyValue, ValueResetFlags)RadObject.GetDefaultValue(RadPropertyValue, object)RadObject.CoerceValue(RadPropertyValue, object)RadObject.ShouldSerializeProperty(RadProperty)RadObject.CanRaisePropertyChangeNotifications(RadPropertyValue)RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)RadObject.UnbindProperty(RadProperty)RadObject.AddStylePropertySetting(IPropertySetting)RadObject.GetInheritedValue(RadProperty)RadObject.OnPropertyChanging(RadPropertyChangingEventArgs)RadObject.OnPropertyChanged(RadPropertyChangedEventArgs)RadObject.OnNotifyPropertyChanged(string)RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadObject.OnShouldSerializeProperty(ShouldSerializePropertyEventArgs)RadObject.IsPropertyCancelable(RadPropertyMetadata)RadObject.PropertyValuesRadObject.PropertyFilterRadObject.RadObjectTypeRadObject.BindingContextRadObject.PropertyChangedRadObject.RadPropertyChangedRadObject.RadPropertyChangingDisposableObject.GetBitState(long)DisposableObject.SetBitState(long, bool)DisposableObject.OnBitStateChanged(long, bool, bool)DisposableObject.Dispose()DisposableObject.Dispose(bool)DisposableObject.PerformDispose(bool)DisposableObject.DisposeUnmanagedResources()DisposableObject.EventsDisposableObject.IsDisposingDisposableObject.IsDisposedDisposableObject.DisposedDisposableObject.Disposing...

Constructors

Creates a layout box for a table cell or a fragment produced when the cell content is split.

C#
public TableCellLayoutBox(DocumentElement associatedDocumentElement, DocumentStructureCollection collection, bool isFragment)
Parameters:associatedDocumentElementDocumentElement

The table cell represented by the box.

collectionDocumentStructureCollection

The document structure collection that owns the box.

isFragmentbool

true when the box represents a continuation of a split cell.

Creates the original, non-fragment layout box for a table cell.

C#
public TableCellLayoutBox(DocumentElement associatedDocumentElement, DocumentStructureCollection collection)
Parameters:associatedDocumentElementDocumentElement

The table cell represented by the box.

collectionDocumentStructureCollection

The document structure collection that owns the box.

Properties

Gets the table cell model represented by this layout box.

C#
public TableCell AssociatedTableCell { get; }

Gets whether the cell background has a visible alpha value.

C#
public override bool HasVisualRepresentation { get; }

Overrides: LayoutBox.HasVisualRepresentation

Gets whether this cell currently provides the vertical-growth policy for its contents. The table layout can enable this role temporarily while sizing row-spanning cells.

C#
public override bool IsTopContainer { get; }

Overrides: LayoutElement.IsTopContainer

Methods

Arranges child blocks inside the cell padding and applies vertical alignment when the cell content remains in its first box.

C#
protected override SizeF ArrangeOverride(SizeF finalSize)
Parameters:finalSizeSizeF

The size assigned to the cell box.

Returns:

SizeF

The cell's desired size after arranging its blocks.

Overrides: LayoutElement.ArrangeOverride(SizeF)

Determines whether the cell's current container or row-span height restriction can accommodate additional content.

C#
protected override bool? CanGrowVerticallyOverride(float desiredHeight)
Parameters:desiredHeightfloat

The height requested by the cell contents, including accumulated layout growth.

Returns:

bool?

true when growth is unrestricted or fits the restriction; false when it exceeds the restriction; null only when currentY is zero and desiredHeight exceeds the restriction. Cell padding contributes to currentY, so an oversized first block in a padded cell can return false instead.

Overrides: LayoutBox.CanGrowVerticallyOverride(float)

Creates a continuation box for the same table cell and document structure collection.

C#
public override LayoutElement CreateLayoutElement()
Returns:

LayoutElement

A fragment TableCellLayoutBox.

Overrides: LayoutBox.CreateLayoutElement()

Measures the cell's block content and repeats internal passes until floating-block placement is complete. In paged layout, it also verifies that affected floating blocks are included.

C#
protected override SizeF MeasureOverride(SizeF availableSize)
Parameters:availableSizeSizeF

The size available to the cell, including its padding.

Returns:

SizeF

The measured cell size.

Overrides: LayoutElement.MeasureOverride(SizeF)

Measures child blocks inside the cell padding, splitting content when page height is insufficient and applying row-span height rules.

C#
protected SizeF MeasureOverrideInternal(SizeF availableSize)
Parameters:availableSizeSizeF

The size available to the cell, including padding.

Returns:

SizeF

The measured content size with cell padding included.