エクスポート (0) 印刷
すべて展開
展開 最小化

FrameworkElement.FindName メソッド

更新 : 2007 年 11 月

指定した識別名を持つ要素を検索します。

名前空間 :  System.Windows
アセンブリ :  PresentationFramework (PresentationFramework.dll 内)

public Object FindName(
	string name
)
public Object FindName(
	String name
)
public function FindName(
	name : String
) : Object
メソッドは XAML では使用できません。

パラメータ

name
型 : System.String

要求した要素の名前。

戻り値

型 : System.Object

要求された要素。一致する要素が見つからなかった場合は null になります。

要素に子要素がある場合は、要求した名前の要素がすべての子要素で再帰的に検索されます。

FindName は、現在の要素の名前スコープ内で動作します。詳細については、「WPF 名前スコープ」を参照してください。

FindName メソッドを使用して要素をその Name 値で検索する方法を次の例に示します。

この例では、特定の要素をその名前で検索するメソッドを、ボタンのイベント ハンドラとして作成しています。stackPanel は、検索対象のルート FrameworkElementName で、この例のメソッドは、見つかった要素を TextBlock としてキャストし、TextBlock で表示可能な UI プロパティの 1 つを変更することで、視覚的に示します。

void Find(object sender, RoutedEventArgs e)
{
    object wantedNode = stackPanel.FindName("dog");
    if (wantedNode is TextBlock)
    {
        // Following executed if Text element was found.
        TextBlock wantedChild = wantedNode as TextBlock;
        wantedChild.Foreground = Brushes.Blue;
    }
}


サンプル全体については、「要素の検索のサンプル」を参照してください。

Windows Vista

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

.NET Framework

サポート対象 : 3.5、3.0

コミュニティの追加

追加
表示:
© 2014 Microsoft