Class GridCellCheckBoxRenderer

Represents the class that maintains the rendering of GridCheckBoxColumn

Inheritance
System.Object
GridCellRendererBase
GridVirtualizingCellRendererBase<System.Windows.Controls.CheckBox, System.Windows.Controls.CheckBox>
GridVirtualizingCellRenderer<System.Windows.Controls.CheckBox, System.Windows.Controls.CheckBox>
GridCellCheckBoxRenderer
Implements
System.IDisposable
Inherited Members
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Syncfusion.UI.Xaml.Grid.Cells
Assembly: Syncfusion.SfGrid.WPF.dll
Syntax
public class GridCellCheckBoxRenderer : GridVirtualizingCellRenderer<CheckBox, CheckBox>, IGridCellRenderer, IDisposable
Examples
this.sfDataGrid.CellRenderers.Remove("CheckBox");
this.sfDataGrid.CellRenderers.Add("CheckBox", new GridCellCheckBoxRendererExt());
public class GridCellCheckBoxRendererExt : GridCellCheckBoxRenderer
{
public override void OnInitializeEditElement(DataColumnBase dataColumn, CheckBox uiElement, object dataContext)
   {
       uiElement.SelectionShape = SelectionShape.Circle;
       uiElement.SelectionHighlightMode = SelectionHighlightMode.Filled;
       base.OnInitializeEditElement(dataColumn, uiElement, dataContext);
   }
}

Constructors

GridCellCheckBoxRenderer()

Initializes a new instance of the GridCellCheckBoxRenderer class.

Declaration
public GridCellCheckBoxRenderer()

Fields

IsCheckedProperty

Dependency registration for IsChecked proeprty.

Declaration
public static readonly DependencyProperty IsCheckedProperty
Field Value
Type Description
System.Windows.DependencyProperty

Methods

CanCheckAddNewRowAtFirstClick()

Method that used to decide whether AddNewRow check box column can get check at first click or not.

Declaration
protected virtual bool CanCheckAddNewRowAtFirstClick()
Returns
Type Description
System.Boolean

CanUpdateBinding(GridColumn)

Determines whether the binding for the column can be updated.Implement this method to update binding on particular renderer whether the data context is set.

Declaration
public override bool CanUpdateBinding(GridColumn column)
Parameters
Type Name Description
GridColumn column

The corresponding column.
Returns
Type Description
System.Boolean

true if the binding is updated for the column; otherwise false.
Overrides

EndEdit(DataColumnBase, Object, Boolean)

Ends the edit occuring on the cell.

Declaration
public override bool EndEdit(DataColumnBase dc, object record, bool canResetBinding = false)
Parameters
Type Name Description
DataColumnBase dc

The data column.
System.Object record

The record.
System.Boolean canResetBinding

Indicates whether binding can be reset or not.
Returns
Type Description
System.Boolean

true if the edit ends on the cell; otherwise false.
Overrides
Syncfusion.UI.Xaml.Grid.Cells.GridVirtualizingCellRendererBase<System.Windows.Controls.CheckBox, System.Windows.Controls.CheckBox>.EndEdit(Syncfusion.UI.Xaml.Grid.DataColumnBase, System.Object, System.Boolean)

GetControlValue()

Gets the control value.

Declaration
public override object GetControlValue()
Returns
Type Description
System.Object
Overrides

GetIsChecked(DependencyObject)

Gets the IsChecked attached property value of CheckBox which is bound with underlying data object.

Declaration
public static object GetIsChecked(DependencyObject obj)
Parameters
Type Name Description
System.Windows.DependencyObject obj
Returns
Type Description
System.Object
Remarks

IsChecked attached property used only when GridCheckBoxColumn.IsThreeState is true.

OnEditElementLoaded(Object, RoutedEventArgs)

Invoked when the edit element(CheckBox) is loaded on the cell in column

Declaration
protected override void OnEditElementLoaded(object sender, RoutedEventArgs e)
Parameters
Type Name Description
System.Object sender

The sender.
System.Windows.RoutedEventArgs e

The System.Windows.RoutedEventArgs instance containing the event data.
Overrides
Syncfusion.UI.Xaml.Grid.Cells.GridVirtualizingCellRendererBase<System.Windows.Controls.CheckBox, System.Windows.Controls.CheckBox>.OnEditElementLoaded(System.Object, System.Windows.RoutedEventArgs)

OnEditElementUnloaded(Object, RoutedEventArgs)

Invoked when the edit element(CheckBox) is unloaded on the cell in column.

Declaration
protected override void OnEditElementUnloaded(object sender, RoutedEventArgs e)
Parameters
Type Name Description
System.Object sender

The sender.
System.Windows.RoutedEventArgs e

The System.Windows.RoutedEventArgs instance containing the event data.
Overrides
Syncfusion.UI.Xaml.Grid.Cells.GridVirtualizingCellRendererBase<System.Windows.Controls.CheckBox, System.Windows.Controls.CheckBox>.OnEditElementUnloaded(System.Object, System.Windows.RoutedEventArgs)

OnInitializeEditElement(DataColumnBase, CheckBox, Object)

Method which is initialize the Renderer element Bindings with corresponding column values.

Declaration
public override void OnInitializeEditElement(DataColumnBase dataColumn, CheckBox uiElement, object dataContext)
Parameters
Type Name Description
DataColumnBase dataColumn

DataColumn Which holds GridColumn, RowColumnIndex and GridCell
System.Windows.Controls.CheckBox uiElement

Corresponding Renderer Element
System.Object dataContext
Overrides
Syncfusion.UI.Xaml.Grid.Cells.GridVirtualizingCellRenderer<System.Windows.Controls.CheckBox, System.Windows.Controls.CheckBox>.OnInitializeEditElement(Syncfusion.UI.Xaml.Grid.DataColumnBase, System.Windows.Controls.CheckBox, System.Object)

OnRenderContent(DrawingContext, Rect, Geometry, DataColumnBase, GridCell, Object)

Declaration
protected override void OnRenderContent(DrawingContext dc, Rect cellRect, Geometry clipGeometry, DataColumnBase dataColumnBase, GridCell gridCell, object dataContext)
Parameters
Type Name Description
System.Windows.Media.DrawingContext dc
System.Windows.Rect cellRect
System.Windows.Media.Geometry clipGeometry
DataColumnBase dataColumnBase
GridCell gridCell
System.Object dataContext
Overrides
Syncfusion.UI.Xaml.Grid.Cells.GridVirtualizingCellRendererBase<System.Windows.Controls.CheckBox, System.Windows.Controls.CheckBox>.OnRenderContent(System.Windows.Media.DrawingContext, System.Windows.Rect, System.Windows.Media.Geometry, Syncfusion.UI.Xaml.Grid.DataColumnBase, Syncfusion.UI.Xaml.Grid.GridCell, System.Object)

OnUnwireEditUIElement(CheckBox)

Unwires the events associated with edit UIElement

Declaration
protected override void OnUnwireEditUIElement(CheckBox uiElement)
Parameters
Type Name Description
System.Windows.Controls.CheckBox uiElement

The Corresponding UIElement.
Overrides
Syncfusion.UI.Xaml.Grid.Cells.GridVirtualizingCellRendererBase<System.Windows.Controls.CheckBox, System.Windows.Controls.CheckBox>.OnUnwireEditUIElement(System.Windows.Controls.CheckBox)

OnUpdateEditBinding(DataColumnBase, CheckBox, Object)

Method which is used to update the Renderer element Bindings with corresponding column values.

Declaration
public override void OnUpdateEditBinding(DataColumnBase dataColumn, CheckBox element, object dataContext)
Parameters
Type Name Description
DataColumnBase dataColumn

DataColumn Which holds GridColumn, RowColumnIndex and GridCell
System.Windows.Controls.CheckBox element

Corresponding Renderer Element
System.Object dataContext

dataContext of the row
Overrides
Syncfusion.UI.Xaml.Grid.Cells.GridVirtualizingCellRenderer<System.Windows.Controls.CheckBox, System.Windows.Controls.CheckBox>.OnUpdateEditBinding(Syncfusion.UI.Xaml.Grid.DataColumnBase, System.Windows.Controls.CheckBox, System.Object)

SetControlValue(Object)

Sets the control value.

Declaration
public override void SetControlValue(object value)
Parameters
Type Name Description
System.Object value

The value.
Overrides

SetCurrentCellState(RowColumnIndex, FrameworkElement, Boolean, Boolean, GridColumn, DataColumnBase)

Sets the current cell state when the cell is activated.

Declaration
public override void SetCurrentCellState(RowColumnIndex currentCellIndex, FrameworkElement currentCellElement, bool isInEditing, bool isFocused, GridColumn column, DataColumnBase dc)
Parameters
Type Name Description
RowColumnIndex currentCellIndex

Specifies the index of cell.
System.Windows.FrameworkElement currentCellElement

The corresponding current cell uielement.
System.Boolean isInEditing

Specifies whether the current cell is editable or not.
System.Boolean isFocused

Specifies whether the current cell is focused or not.
GridColumn column

The corresponding column to set the current cell state.
DataColumnBase dc

The corresponding data column to set the current cell state.
Overrides

SetIsChecked(DependencyObject, Object)

Sets the IsChecked attached property value of CheckBoox which is bound with underlying data object.

Declaration
public static void SetIsChecked(DependencyObject obj, object value)
Parameters
Type Name Description
System.Windows.DependencyObject obj
System.Object value
Remarks

IsChecked attached property used only when GridCheckBoxColumn.IsThreeState is true.

ShouldGridTryToHandleKeyDown(KeyEventArgs)

Shoulds the grid try automatic handle key down.

Declaration
protected override bool ShouldGridTryToHandleKeyDown(KeyEventArgs e)
Parameters
Type Name Description
System.Windows.Input.KeyEventArgs e

The instance containing the event data.
Returns
Type Description
System.Boolean
Overrides
Syncfusion.UI.Xaml.Grid.Cells.GridVirtualizingCellRenderer<System.Windows.Controls.CheckBox, System.Windows.Controls.CheckBox>.ShouldGridTryToHandleKeyDown(System.Windows.Input.KeyEventArgs)

Implements

System.IDisposable