PivotCellElement
Displays the aggregate value at the intersection of a pivot row and column group, including selection, subtotal, grand-total, and KPI display state.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.PivotGrid.dll
Syntax:
public class PivotCellElement : LightVisualElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider, IVirtualizedElement<PivotGroupNode>
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementPivotCellElement...
Implements:
Inherited Members
Constructors
Initializes a cell visual associated with the specified grid and row.
public PivotCellElement(RadPivotGridElement owner, PivotRowElement row)
The grid element that owns the cell.
rowPivotRowElementThe visual row that contains the cell.
Fields
Identifies the property used to activate the grand-total-column visual state.
public static RadProperty GrandTotalColumnProperty
Identifies the property used to activate the grand-total-row visual state.
public static RadProperty GrandTotalRowProperty
Identifies the property that indicates whether the cell is selected.
public static RadProperty IsSelectedProperty
Identifies the property used to activate the subtotal-column visual state.
public static RadProperty SubTotalColumnProperty
Identifies the property used to activate the subtotal-row visual state.
public static RadProperty SubTotalRowProperty
Properties
Gets the aggregate description used to calculate this cell's value, or null when no aggregate value or description is available.
public IAggregateDescription AggregateDescription { get; }
Gets the column-group node whose intersection with Row determines this cell's aggregate.
public PivotGroupNode Column { get; }
Gets the column-group node bound to this virtualized element by its container.
public PivotGroupNode Data { get; }
Implements:
Gets the formatted aggregate value shown as cell text, or an empty string while the value is unavailable.
public string FormattedValue { get; }
Gets whether the column group represented by this cell is the grand total.
public bool IsInGrandTotalColumn { get; }
Gets whether the row group represented by this cell is the grand total.
public bool IsInGrandTotalRow { get; }
Gets whether the column group represented by this cell is a subtotal.
public bool IsInSubTotalColumn { get; }
Gets whether the row group represented by this cell is a subtotal.
public bool IsInSubTotalRow { get; }
Gets whether the aggregate description requests KPI rendering for this cell.
public bool IsKPI { get; }
Gets the selection state last synchronized from the grid's selection model.
public bool IsSelected { get; }
Gets or sets the shared image displayed for a KPI cell with a negative double value.
public static Image Negative { get; set; }
Gets or sets the shared image displayed for a KPI cell whose double value is zero.
public static Image Neutral { get; set; }
Gets the grid element that owns this cell and supplies its selection and data state.
public RadPivotGridElement Owner { get; }
Gets or sets the shared image displayed for a KPI cell with a positive double value.
public static Image Positive { get; set; }
Gets the row-group node represented by the cell's containing visual row.
public virtual PivotGroupNode Row { get; }
Gets the visual row that contains this cell.
public PivotRowElement RowElement { get; }
Methods
Associates the cell with a column-group node and synchronizes its displayed state.
public virtual void Attach(PivotGroupNode data, object context)
The column-group node represented by the cell.
contextobjectVirtualization context supplied by the container; this implementation does not use it.
Implements:
Enables border drawing for the cell element.
protected override void CreateChildElements()
Overrides:
Clears the attached column-group node so the virtualized cell can be reused.
public virtual void Detach()
Implements:
Indicates that this cell visual can be reused for any column-group node; its content is updated by Attach(PivotGroupNode, object).
public bool IsCompatible(PivotGroupNode data, object context)
The column-group node proposed for the cell.
contextobjectVirtualization context supplied by the container.
Returns:Always true because the cell is rebound to new data when attached.
Implements:
Raises the visual stacking order of the cell and its row when the cell becomes selected or hovered.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
The property-change details.
Overrides:
Refreshes cell state and content from the current row and column groups, then raises the cell-formatting event. No refresh occurs while the data provider is retrieving data.
public void Synchronize()
Implements:
Updates selection and total-state properties and chooses the displayed text or KPI image.
protected virtual void SynchronizeProperties()