DetachColumnElement Method

Called when a column element is scrolled out of view to "uninitialize" the element. This element will the be made available for use by a different item (i.e., recyclable). If the element is used by a different item, the AttachElement method will be called using the path of the new item.

Syntax

Visual Basic
C#

'Declaration
 
Protected Overridable Sub DetachColumnElement( _
   ByVal element As FrameworkElement _
)

'Usage
 
Dim instance As DataGridControl
Dim element As FrameworkElement
 
instance.DetachColumnElement(element)

protected virtual void DetachColumnElement( 
   FrameworkElement element
)

Parameters

element: The associated element.

Remarks

If a grouping, sorting, or filtering operation is made, all recyclable elements will be cleared and the initialization process from PrepareColumnElement to DetachColumnElement will be restarted.

The DetachColumnElement method is not necessarily called as soon as an element is added to the recycling pool; it is sometimes called just prior to being attached to another item. This behavior was designed to prevent detaching a element that might be reused with exactly the same item.

The base implementations do not need to be called when overriding the PrepareColumnElement, AttachColumnElement, DetachColumnElement, and ClearColumnElement methods.

Requirements

Target Platforms: Windows 7, Windows Vista, Windows XP SP3, Windows Server 2008 family

Reference

DataGridControl Class
DataGridControl Members