ContinueDescendantSearch メソッド (UIElement)

このメソッドは最適化の一手法として、検索対象の要素を含む可能性のない要素パスを検索から除外するために GetDescendant(Type) から呼び出されます。

シンタックス

Visual Basic

'宣言
 
Protected Overridable Function ContinueDescendantSearch( _
   ByVal type As Type, _
   ByVal contexts() As Object _
) As Boolean

C#

protected virtual bool ContinueDescendantSearch( 
   Type type,
   object[] contexts
)

パラメータ

type

検索対象の UIElement の System.Type (または基本クラス タイプ)。

contexts

UIElementのコンテキストにすべて一致する必要があるコンテキスト。

戻り値の型

検索対象の要素がこの要素の子孫である可能性がある場合はTrue。このメソッドがFalseを返す場合、この要素の子孫要素は検索から除外されます。

解説

デフォルト実装は type パラメーターを使用しません。この要素が PrimaryContext を持ち、その型が渡されたコンテキストの 1 つの型に一致していて、なおかつコンテキスト オブジェクトが同じでない場合を除いて、常に True を返します。

たとえば、UltraGrid コントロール内の CellUIElement を検索するときに、この要素が RowUIElement であり、その PrimaryContext が、対応する UltraGridRow オブジェクトであり、渡されたコンテキストの 1 つが UltraGridRow 型ではあるが異なる UltraGridRow の場合、検索するセルが子孫である可能性はないため、この他の行の子孫要素はすべて無視してもかまいません。

ただし、 が System.DateTime 型の場合、デフォルトの実装は常に True を返します。これは、DateTime コンテキストの意味がその日付部分、時刻部分、またはその両方にある可能性があり、等価性に基づいて仮定を立てることができないためです。

このメソッドは通常、GetContext(Type) メソッドをオーバーライドするクラス、または型またはコンテキストに基づいて追加の最適化を提供できるクラスによってオーバーライドされます。