FrameworkContentElement.FindName(String) Metoda

Definicja

Znajduje element o podanej nazwie identyfikatora.Finds an element that has the provided identifier name.

public:
 System::Object ^ FindName(System::String ^ name);
public object FindName (string name);
member this.FindName : string -> obj
Public Function FindName (name As String) As Object

Parametry

name
String

Nazwa elementu do wyszukania.Name of the element to search for.

Zwraca

Żądany element.The requested element. Może być null, jeśli nie znaleziono pasującego elementu.May be null if no matching element was found.

Przykłady

Poniższy przykład ustawia właściwość dla elementu znalezionego przez nazwę w obrębie FlowDocument, do którego istnieje odwołanie na stronie.The following example sets a property on an element found by name within a referenced FlowDocument on a page.

void HighlightParagraph(string paraName)
{
    try
    {
        Paragraph wantedNode = (Paragraph)myflowdocument.FindName(paraName);
        if (wantedNode != null)
        {
            wantedNode.Background = Brushes.LightYellow;
        }
    }
    catch { }//handle paragraph not found in UI }
}
Private Sub HighlightParagraph(ByVal paraName As String)
    Try
        Dim wantedNode As Paragraph = CType(myflowdocument.FindName(paraName), Paragraph)
        If wantedNode IsNot Nothing Then
            wantedNode.Background = Brushes.LightYellow
        End If
    Catch 'handle paragraph not found in UI }
    End Try
End Sub

Uwagi

Jeśli ten element ma elementy podrzędne, te elementy podrzędne są przeszukiwane cyklicznie dla żądanego nazwanego elementu.If this element has child elements, these child elements are all searched recursively for the requested named element.

Dotyczy