DetachElement Method

Called when an 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 DetachElement( _
   ByVal element As FrameworkElement _
)

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

protected virtual void DetachElement( 
   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 PrepareElement to DetachElement will be restarted.

The DetachElement 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 PrepareElement, AttachElement, DetachElement, and ClearElement methods.

Requirements

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

Reference

DataGridControl Class
DataGridControl Members

Paths and Containers

Container Recycling