Class

RadVirtualGrid

Initializes a new instance of the RadVirtualGrid class.

Declaration

public RadVirtualGrid()

Represents the ActionOnLostFocus dependency property.

Declaration

public static readonly DependencyProperty ActionOnLostFocusProperty

Field Value

Represents the AlternationBrush dependency property.

Declaration

public static readonly DependencyProperty AlternationBrushProperty

Field Value

Represents the CanUserDeleteRows dependency property.

Declaration

public static readonly DependencyProperty CanUserDeleteRowsProperty

Field Value

Represents the CanUserEdit dependency property.

Declaration

public static readonly DependencyProperty CanUserEditProperty

Field Value

Represents the CanUserFilterColumns dependency property.

Declaration

public static readonly DependencyProperty CanUserFilterColumnsProperty

Field Value

Represents the CanUserInsertRows dependency property.

Declaration

public static readonly DependencyProperty CanUserInsertRowsProperty

Field Value

Represents the CanUserResizeColumns dependency property.

Declaration

public static readonly DependencyProperty CanUserResizeColumnsProperty

Field Value

Represents the CanUserResizeRows dependency property.

Declaration

public static readonly DependencyProperty CanUserResizeRowsProperty

Field Value

Represents the CanUserEdit dependency property.

Declaration

public static readonly DependencyProperty CanUserSelectProperty

Field Value

Represents the CanUserSortColumns dependency property.

Declaration

public static readonly DependencyProperty CanUserSortColumnsProperty

Field Value

Represents the CellPadding dependency property.

Declaration

public static readonly DependencyProperty CellPaddingProperty

Field Value

Represents the CellTextAlignment dependency property.

Declaration

public static readonly DependencyProperty CellTextAlignmentProperty

Field Value

Identifies the CellToolTipTemplate dependency property.

Declaration

public static readonly DependencyProperty CellToolTipTemplateProperty

Field Value

Represents the ClipboardCopyMode dependency property.

Declaration

public static readonly DependencyProperty ClipboardCopyModeProperty

Field Value

Represents the ColumnAlternationCount dependency property.

Declaration

public static readonly DependencyProperty ColumnAlternationCountProperty

Field Value

Represents the ColumnHeaderBackground dependency property.

Declaration

public static readonly DependencyProperty ColumnHeaderBackgroundProperty

Field Value

Represents the ColumnHeaderForeground dependency property.

Declaration

public static readonly DependencyProperty ColumnHeaderForegroundProperty

Field Value

Represents the ColumnHeaderHeight dependency property.

Declaration

public static readonly DependencyProperty ColumnHeaderHeightProperty

Field Value

Represents the ColumnHeaderLinesBrush dependency property.

Declaration

public static readonly DependencyProperty ColumnHeaderLinesBrushProperty

Field Value

Represents the ColumnWidth dependency property.

Declaration

public static readonly DependencyProperty ColumnWidthProperty

Field Value

Occurs after copying the RadVirtualGrid's selected cells to the Clipboard.

Declaration

public static readonly RoutedEvent CopiedEvent

Field Value

Occurs on copying a cell to the Clipboard.

Declaration

public static readonly RoutedEvent CopyingCellClipboardContentEvent

Field Value

Occurs on copying the RadVirtualGrid's selected cells to the Clipboard.

Declaration

public static readonly RoutedEvent CopyingEvent

Field Value

Represents the CurrentCellStroke dependency property.

Declaration

public static readonly DependencyProperty CurrentCellStrokeProperty

Field Value

Represents the DataProvider dependency property.

Declaration

public static readonly DependencyProperty DataProviderProperty

Field Value

Represents the EditTriggers dependency property.

Declaration

public static readonly DependencyProperty EditTriggersProperty

Field Value

Represents the FilterIconBackgroundFiltered dependency property.

Declaration

public static readonly DependencyProperty FilterIconBackgroundFilteredProperty

Field Value

Represents the FilterIconBackground dependency property.

Declaration

public static readonly DependencyProperty FilterIconBackgroundProperty

Field Value

Represents the HorizontalLinesBrush dependency property.

Declaration

public static readonly DependencyProperty HorizontalLinesBrushProperty

Field Value

Represents the InitialColumnCount dependency property.

Declaration

public static readonly DependencyProperty InitialColumnCountProperty

Field Value

Represents the InitialRowCount dependency property.

Declaration

public static readonly DependencyProperty InitialRowCountProperty

Field Value

Represents the IsFilterable dependency property.

Declaration

public static readonly DependencyProperty IsFilterableProperty

Field Value

Represents the IsFilteringDeferred dependency property.

Declaration

public static readonly DependencyProperty IsFilteringDeferredProperty

Field Value

Represents the IsSortable dependency property.

Declaration

public static readonly DependencyProperty IsSortableProperty

Field Value

Represents the LinesVisibility dependency property.

Declaration

public static readonly DependencyProperty LinesVisibilityProperty

Field Value

Represents the MeasureTextOnRender dependency property.

Declaration

public static readonly DependencyProperty MeasureTextOnRenderProperty

Field Value

Represents the PinnedCellBackground dependency property.

Declaration

public static readonly DependencyProperty PinnedCellBackgroundProperty

Field Value

Represents the PinnedCellForeground dependency property.

Declaration

public static readonly DependencyProperty PinnedCellForegroundProperty

Field Value

Represents the PinnedRowHeaderBackground dependency property.

Declaration

public static readonly DependencyProperty PinnedRowHeaderBackgroundProperty

Field Value

Represents the RowAlternationCount dependency property.

Declaration

public static readonly DependencyProperty RowAlternationCountProperty

Field Value

Represents the RowHeaderBackground dependency property.

Declaration

public static readonly DependencyProperty RowHeaderBackgroundProperty

Field Value

Represents the RowHeaderForeground dependency property.

Declaration

public static readonly DependencyProperty RowHeaderForegroundProperty

Field Value

Represents the RowHeaderLinesBrush dependency property.

Declaration

public static readonly DependencyProperty RowHeaderLinesBrushProperty

Field Value

Represents the RowHeaderWidth dependency property.

Declaration

public static readonly DependencyProperty RowHeaderWidthProperty

Field Value

Represents the RowHeight dependency property.

Declaration

public static readonly DependencyProperty RowHeightProperty

Field Value

Identifies the SelectedIndexProperty dependency property.

Declaration

public static readonly DependencyProperty SelectedIndexProperty

Field Value

Represents the SelectionBrush dependency property.

Declaration

public static readonly DependencyProperty SelectionBrushProperty

Field Value

Identifies the SelectionChanged routed event.

Declaration

public static readonly RoutedEvent SelectionChangedEvent

Field Value

Identifies the SelectionModeProperty dependency property.

Declaration

public static readonly DependencyProperty SelectionModeProperty

Field Value

Identifies the SelectionUnitProperty dependency property.

Declaration

public static readonly DependencyProperty SelectionUnitProperty

Field Value

Represents the ShouldCreateAutomationPeer dependency property.

Declaration

public static readonly DependencyProperty ShouldCreateAutomationPeerProperty

Field Value

Represents the ShowCellToolTip dependency property.

Declaration

public static readonly DependencyProperty ShowCellToolTipProperty

Field Value

Represents the ShowDistinctFilters dependency property.

Declaration

public static readonly DependencyProperty ShowDistinctFiltersProperty

Field Value

Represents the ShowFieldFilters dependency property.

Declaration

public static readonly DependencyProperty ShowFieldFiltersProperty

Field Value

Represents the SortIndicatorBackground dependency property.

Declaration

public static readonly DependencyProperty SortIconBackgroundProperty

Field Value

Represents the SortedHeaderBackground dependency property.

Declaration

public static readonly DependencyProperty SortedHeaderBackgroundProperty

Field Value

Represents the SortedHeaderForeground dependency property.

Declaration

public static readonly DependencyProperty SortedHeaderForegroundProperty

Field Value

Represents the VerticalLinesBrush dependency property.

Declaration

public static readonly DependencyProperty VerticalLinesBrushProperty

Field Value

Gets or sets the action to take when an element of the RadVirtualGrid loses focus.

Declaration

public ActionOnLostFocus ActionOnLostFocus { get; set; }

Property Value

Get or sets the alternation color.

Declaration

public Brush AlternationBrush { get; set; }

Property Value

Gets or sets a value that indicates whether the user can delete rows.

Declaration

public bool CanUserDeleteRows { get; set; }

Property Value

Gets or sets a value that indicates whether data can be modified through user input.

Declaration

public bool CanUserEdit { get; set; }

Property Value

Gets or sets a value that indicates whether users can filter columns through the UI.

Declaration

public bool CanUserFilterColumns { get; set; }

Property Value

Gets or sets a value that indicates whether the user can add new rows.

Declaration

public bool CanUserInsertRows { get; set; }

Property Value

Gets or sets a value that indicates whether users can resize columns through the UI.

Declaration

public bool CanUserResizeColumns { get; set; }

Property Value

Gets or sets a value that indicates whether users can resize rows through the UI.

Declaration

public bool CanUserResizeRows { get; set; }

Property Value

Gets or sets a value that indicates whether a user can select rows or cells.

Declaration

public bool CanUserSelect { get; set; }

Property Value

Gets or sets a value that indicates whether users can sort columns through the UI.

Declaration

public bool CanUserSortColumns { get; set; }

Property Value

Gets or sets a value that indicates the cells' text padding.

Declaration

public Thickness CellPadding { get; set; }

Property Value

Gets or sets the text alignment.

Declaration

public TextAlignment CellTextAlignment { get; set; }

Property Value

Gets or sets the ContentTemplate of the tooltip that is shown for RadVirtualGrid cells.

Declaration

public DataTemplate CellToolTipTemplate { get; set; }

Property Value

Gets or sets a value that indicates how data is copied to the clipboard.

Declaration

public VirtualGridClipboardCopyMode ClipboardCopyMode { get; set; }

Property Value

Remarks

Gets or sets the alternation step for columns.

Declaration

public int ColumnAlternationCount { get; set; }

Property Value

Gets or sets the column headers' background.

Declaration

public Brush ColumnHeaderBackground { get; set; }

Property Value

Gets or sets the column headers' foreground.

Declaration

public Brush ColumnHeaderForeground { get; set; }

Property Value

Gets or sets the height of the column headers.

Declaration

public double ColumnHeaderHeight { get; set; }

Property Value

Gets or sets the column header lines' stroke brush.

Declaration

public Brush ColumnHeaderLinesBrush { get; set; }

Property Value

Gets or sets the width of the columns.

Declaration

public double ColumnWidth { get; set; }

Property Value

Gets or sets the current cell info.

Declaration

public VirtualGridCellInfo CurrentCellInfo { get; set; }

Property Value

Gets or sets the stroke brush of the current cell.

Declaration

public Brush CurrentCellStroke { get; set; }

Property Value

Gets or sets the data provider.

Declaration

public DataProvider DataProvider { get; set; }

Property Value

Gets or sets the edit triggers.

Declaration

public VirtualGridEditTriggers EditTriggers { get; set; }

Property Value

Gets or sets the filter icon background brush.

Declaration

public Brush FilterIconBackground { get; set; }

Property Value

Gets or sets the filter icon background brush when the column is filtered.

Declaration

public Brush FilterIconBackgroundFiltered { get; set; }

Property Value

Gets or sets the horizontal lines' stroke brush.

Declaration

public Brush HorizontalLinesBrush { get; set; }

Property Value

Gets or sets the initial column count.

Declaration

public int InitialColumnCount { get; set; }

Property Value

Gets or sets the initial row count.

Declaration

public int InitialRowCount { get; set; }

Property Value

Gets or sets a value that indicates whether programmatic and UI filtering is possible.

Declaration

public bool IsFilterable { get; set; }

Property Value

Gets or sets a value that indicates whether deferred filtering is enabled.

Declaration

public bool IsFilteringDeferred { get; set; }

Property Value

Gets or sets a value that indicates whether programmatic and UI sorting is possible.

Declaration

public bool IsSortable { get; set; }

Property Value

Gets the keyboard command provider.

Declaration

public IKeyboardCommandProvider KeyboardCommandProvider { get; set; }

Property Value

Gets or sets the lines' visibility.

Declaration

public VirtualGridLinesVisibility LinesVisibility { get; set; }

Property Value

Gets or sets a value that indicates whether text is measured when rendering. Setting it to true enables changing TextAlignment and FitColumnWidthToContent. It may affect rendering performance.

Declaration

public bool MeasureTextOnRender { get; set; }

Property Value

Gets all pending commands.

Declaration

public List<ICommand> PendingCommands { get; }

Property Value

Gets or sets the cells' background when cells are pinned.

Declaration

public Brush PinnedCellBackground { get; set; }

Property Value

Gets or sets the cells' foreground when cells are pinned.

Declaration

public Brush PinnedCellForeground { get; set; }

Property Value

Gets or sets the pinned row headers' background.

Declaration

public Brush PinnedRowHeaderBackground { get; set; }

Property Value

Gets or sets the alternation step for rows.

Declaration

public int RowAlternationCount { get; set; }

Property Value

Gets or sets the row headers' background.

Declaration

public Brush RowHeaderBackground { get; set; }

Property Value

Gets or sets the row header's foreground.

Declaration

public Brush RowHeaderForeground { get; set; }

Property Value

Gets or sets the row header lines' stroke brush.

Declaration

public Brush RowHeaderLinesBrush { get; set; }

Property Value

Gets or sets the width of the row headers.

Declaration

public double RowHeaderWidth { get; set; }

Property Value

Gets or sets the height of the rows.

Declaration

public double RowHeight { get; set; }

Property Value

Gets the selected cells.

Declaration

public IList<VirtualGridCellInfo> SelectedCells { get; }

Property Value

Gets or sets the selected index of RadVirtualGrid.

Declaration

public int SelectedIndex { get; set; }

Property Value

Gets the selected indexes.

Declaration

public IEnumerable<int> SelectedIndexes { get; }

Property Value

Gets or sets a value that indicates the selection brush.

Declaration

public Brush SelectionBrush { get; set; }

Property Value

Gets or sets the selection mode of the VirtualGrid. The default value is System.Windows.Controls.SelectionMode.

Declaration

public SelectionMode SelectionMode { get; set; }

Property Value

Gets or sets the selection unit of the VirtualGrid. The default value is VirtualGridSelectionUnit.FullRow

Declaration

public VirtualGridSelectionUnit SelectionUnit { get; set; }

Property Value

Gets or sets a value indicating whether automation peers for the RadVirtualGrid should be created.

Declaration

public bool ShouldCreateAutomationPeer { get; set; }

Property Value

Remarks

Gets or sets a value indicating whether a tooltip will be shown for RadVirtualGrid cells.

Declaration

public bool ShowCellToolTip { get; set; }

Property Value

Gets or sets a value that indicates whether distinct filters are visible.

Declaration

public bool ShowDistinctFilters { get; set; }

Property Value

Gets or sets a value that indicates whether filed filters are visible.

Declaration

public bool ShowFieldFilters { get; set; }

Property Value

Gets or sets a value that indicates the background of the sort icon.

Declaration

public Brush SortIconBackground { get; set; }

Property Value

Gets or sets the headers' background when the respective columns are sorted.

Declaration

public Brush SortedHeaderBackground { get; set; }

Property Value

Gets or sets the headers' foreground when the respective columns are sorted.

Declaration

public Brush SortedHeaderForeground { get; set; }

Property Value

Gets or sets the vertical lines' stroke brush.

Declaration

public Brush VerticalLinesBrush { get; set; }

Property Value

Propagates filter descriptor changes.

Declaration

protected virtual void ApplyFilterDescriptorChanges(ColumnFilterDescriptor filterDescriptor)

Parameters

Causes the RadVirtualGrid to enter editing mode for a given cell coordinates, unless the data grid is already in editing mode.

Declaration

public void BeginEdit(int rowIndex, int columnIndex)

Parameters

Causes the RadVirtualGrid to show new row and enter into EditMode.

Declaration

public void BeginInsert()

Generates FilteredEventArgs and invokes the FilterDescriptorPrepared event.

Declaration

protected virtual void CallFiltered(IEnumerable<IFilterDescriptor> added, IEnumerable<IFilterDescriptor> removed, int columnIndex)

Parameters

Generates FilteringEventArgs and invokes the FilterDescriptorPreparing event.

Declaration

protected virtual bool CallFiltering(IEnumerable<IFilterDescriptor> added, IEnumerable<IFilterDescriptor> removed, int columnIndex)

Parameters

Returns

Causes the data grid to cancel the current edit, restore the original value, and exit editing mode.

Declaration

public void CancelEdit()

Clears all existing column filters.

Declaration

public virtual void ClearColumnFilters()

Clears the filter descriptors for the given column and resets its filtering control.

Declaration

public virtual void ClearFiltersForColumn(int columnIndex)

Parameters

Closes the filtering UI.

Declaration

public void CloseFilteringControl()

Commits the edit.

Declaration

public void CommitEdit()

Copies RadVirtualGrid selected cells to clipboard.

Declaration

public void CopyToClipboard()

Executes all pending commands in a sequence.

Declaration

public void ExecutePendingCommand()

Invokes the filtering UI for a specific column.

Declaration

public void FilterColumn(int columnIndex)

Parameters

Set column width to be as large as the biggest cell's content, if the MeasureTextOnRender property is set to True.

Declaration

public double FitColumnWidthToContent(int columnIndex)

Parameters

Returns

Retrieves the list of available FilterOperators for a given type.

Declaration

[SuppressMessage("Microsoft.Design", "CA1002:DoNotExposeGenericLists")]
protected virtual List<FilterOperator> GetAvailableOperatorsForType(Type dataType)

Parameters

Returns

Returns the index of a column for a given mouse position.

Declaration

public int GetColumnIndexAtMousePosition(CanvasInputBorder canvasInputBorder)

Parameters

Returns

Gets the ColumnFilterDescriptor for a specific column.

Declaration

public ColumnFilterDescriptor GetFilterDescriptorForColumn(int columnIndex)

Parameters

Returns

Gets the FilteringControl for a specific column.

Declaration

public FilteringControl GetFilteringControlForColumn(int columnIndex)

Parameters

Returns

Returns the index of a row for a given mouse position.

Declaration

public int GetRowIndexAtMousePosition(CanvasInputBorder canvasInputBorder)

Parameters

Returns

Gets the ColumnSortDescriptor for a specific column.

Declaration

public ColumnSortDescriptor GetSortDescriptorForColumn(int columnIndex)

Parameters

Returns

Increases the table capacity by adding a column on the given index.

Declaration

public void InsertNewColumnAtIndex(int index)

Parameters

Increases the table capacity by adding a row on the given index.

Declaration

public void InsertNewRowAtIndex(int index)

Parameters

When overridden in a derived class, is invoked whenever application code or internal processes call .

Declaration

public override void OnApplyTemplate()

Returns an automation peer for RadVirtualGrid.

Declaration

protected override AutomationPeer OnCreateAutomationPeer()

Returns

Invoked DataProvider.DistinctValuesLoading if DataProvider is available, or raises DistinctValuesLoading instead.

Declaration

protected virtual void OnDistinctValuesLoading(DistinctValuesLoadingEventArgs e)

Parameters

Declaration

protected virtual void OnFieldFilterEditorCreated(FieldFilterEditorCreatedEventArgs args)

Parameters

Invokes DataProvider.FilterOperatorsLoading if DataProvider is available or raises FilterOperatorsLoading instead.

Declaration

protected void OnFilterOperatorsLoading(FilterOperatorsLoadingEventArgs e)

Parameters

Invokes the FilterDescriptorPrepared event.

Declaration

protected virtual void OnFiltered(FilteredEventArgs e)

Parameters

Invokes the FilterDescriptorsPreparing event.

Declaration

protected virtual void OnFiltering(FilteringEventArgs e)

Parameters

Raises the event. This method is invoked whenever is set to true internally.

Declaration

protected override void OnInitialized(EventArgs e)

Parameters

Occurs when KeyDown event is raised.

Declaration

protected override void OnPreviewKeyDown(KeyEventArgs e)

Parameters

Raises the SelectedCellsChangingEvent event.

Declaration

protected virtual void OnSelectedCellsChanging(VirtualGridSelectedCellsChangingEventArgs args)

Parameters

Invokes DataProvider.SortDescriptorPreparing if DataProvider is present or invokes the SortDescriptorPreparing event instead.

Declaration

protected virtual void OnSorted(SortedEventArgs e)

Parameters

Invokes DataProvider.SortDescriptorPreparing if DataProvider is present or invokes the SortDescriptorPreparing event instead.

Declaration

protected virtual void OnSorting(SortingEventArgs e)

Parameters

Executed when text has been input.

Declaration

protected override void OnTextInput(TextCompositionEventArgs e)

Parameters

Pins the column left.

Declaration

public void PinColumnLeft(int columnIndex)

Parameters

Pins the column right.

Declaration

public void PinColumnRight(int columnIndex)

Parameters

Pins the row bottom.

Declaration

public void PinRowBottom(int rowIndex)

Parameters

Pins the row top.

Declaration

public void PinRowTop(int rowIndex)

Parameters

Updates VirtualGrid with the given value. It also needs to be persisted in the data source.

Declaration

public void PushCellValue(int rowIndex, int columnIndex, object value)

Parameters

Reduces the table capacity by removing a column on the given index.

Declaration

public void RemoveColumnAtIndex(int index)

Parameters

Reduces the table capacity by removing a row on the given index.

Declaration

public void RemoveRowAtIndex(int index)

Parameters

Resets the control to its initial visual state.

Declaration

public void Reset()

Resets the control to an initial visual state with the given row count and column count.

Declaration

public void Reset(int rowCount, int columnCount)

Parameters

Resets the theme.

Declaration

public void ResetTheme()

Scrolls the column with the specified index into view in an asynchronous manner.

Declaration

public void ScrollColumnIndexIntoViewAsync(int columnIndex, Action scrollFinishedCallback, Action scrollFailedCallback)

Parameters

Remarks

Scrolls the row with the specified index and column into view in an asynchronous manner.

Declaration

public void ScrollIndexIntoViewAsync(int rowIndex, int columnIndex, Action scrollFinishedCallback, Action scrollFailedCallback)

Parameters

Remarks

Scrolls the row with the specified index into view in an asynchronous manner.

Declaration

public void ScrollRowIndexIntoViewAsync(int rowIndex, Action scrollFinishedCallback, Action scrollFailedCallback)

Parameters

Remarks

Selects all the items as defined by the SelectionMode and SelectionUnit

Declaration

public void SelectAll()

Selects specified region of cells.

Declaration

public void SelectCellRegion(CellRegion cellRegion)

Parameters

Selects specified region of cells.

Declaration

public void SelectCellRegion(IEnumerable<CellRegion> cellRegions)

Parameters

Invokes the sorting UI for a specific column.

Declaration

public void SortColumn(int columnIndex)

Parameters

Selects the given index if it is not selected, or deselects if it is already selected.

Declaration

public void ToggleIndexSelection(int index)

Parameters

Unpins the column with the given index.

Declaration

public void UnpinColumn(int columnIndex)

Parameters

Unpins the row with the given index.

Declaration

public void UnpinRow(int rowIndex)

Parameters

Clears the current selection state.

Declaration

public void UnselectAll()

Deselects specified region of cells.

Declaration

public void UnselectCellRegion(CellRegion cellRegion)

Parameters

Deselects specified region of cells.

Declaration

public void UnselectCellRegion(IEnumerable<CellRegion> cellRegions)

Parameters

Update on the row and column headers' UI, taking into account visual properties changes.

Declaration

public void UpdateHeadersUI()

Update on the UI, taking into account visual properties changes.

Declaration

public void UpdateUI()

Occurs when a cell will be visualized. Setting the arguments' properties will visually modify the cell.

Declaration

public event EventHandler<CellDecorationEventArgs> CellDecorationsNeeded

Event Value

Occurs when an edit operation is finished.

Declaration

public event EventHandler<CellEditEndedEventArgs> CellEditEnded

Event Value

Occurs when RadVirtualGrid fetches the DataTemplate for a given cell.

Declaration

public event EventHandler<CellTemplateEventArgs> CellTemplateNeeded

Event Value

Occurs when RadVirtualGrid fetches the value for a cell's tooltip.

Declaration

public event EventHandler<VirtualGridCellToolTipEventArgs> CellToolTipNeeded

Event Value

Occurs when RadVirtualGrid fetches the value for a cell.

Declaration

public event EventHandler<CellValueEventArgs> CellValueNeeded

Event Value

Occurs after the selected cells of the RadVirtualGrid were copied to the Clipboard.

Declaration

public event EventHandler<RadRoutedEventArgs> Copied

Event Value

Occurs before the selected cells of the RadVirtualGrid are copied to the Clipboard.

Declaration

public event EventHandler<VirtualGridClipboardEventArgs> Copying

Event Value

Occurs before a cell is copied to the Clipboard.

Declaration

public event EventHandler<VirtualGridCellClipboardEventArgs> CopyingCellClipboardContent

Event Value