ListViewBase.SingleSelectionFollowsFocus Eigenschaft

Referenz

Definition

Namespace:: Microsoft.UI.Xaml.Controls

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ruft einen Wert ab, der angibt, ob sich die Elementauswahl ändert, wenn sich der Tastaturfokus ändert, oder legt diesen fest.

public:
 property bool SingleSelectionFollowsFocus { bool get(); void set(bool value); };

bool SingleSelectionFollowsFocus();

void SingleSelectionFollowsFocus(bool value);

public bool SingleSelectionFollowsFocus { get; set; }

var boolean = listViewBase.singleSelectionFollowsFocus;
listViewBase.singleSelectionFollowsFocus = boolean;

Public Property SingleSelectionFollowsFocus As Boolean

<listViewBase SingleSelectionFollowsFocus="bool" />

Eigenschaftswert

Boolean

bool

TRUE , wenn sich die Elementauswahl ändert, wenn sich der Tastaturfokus ändert; Andernfalls false. Der Standardwert ist true.

Hinweise

Diese Eigenschaft wird ignoriert, wenn die SelectionMode-Eigenschaft der Listenansicht nicht auf Single festgelegt ist.

Wenn eine Listenansicht für die einzelne Auswahl konfiguriert ist und der Benutzer den Tastaturfokus auf ein Element verschiebt, wird standardmäßig auch das fokussierte Element ausgewählt. Wenn beispielsweise der Tastaturfokus vom ersten Element auf das zweite Element verschoben wird, wird die SelectedIndex-Eigenschaft von 0 auf 1 aktualisiert.

Legen Sie diese Eigenschaft auf false fest, damit ein Benutzer den Fokus verschieben kann, ohne dass die Elementauswahl folgt. Wenn z. B. jede Auswahländerung erhebliche Benutzeroberflächenaktualisierungen verursacht, ziehen Sie es möglicherweise vor, den Benutzer den Fokus auf ein nicht angrenzendes Element zu verschieben und dann die EINGABETASTE zu drücken, um die Auswahl zu aktualisieren.

Versionskompatibilität

Die SingleSelectionFollowsFocus-Eigenschaft ist vor Windows 10 Version 1607 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner als die im Abschnitt "Anforderungen" weiter unten auf dieser Seite angezeigte "eingeführte Version" ist, müssen Sie die App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Versionsadaptiver Code.

Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, legen Sie diese Eigenschaft nicht in XAML fest, oder verwenden Sie sie nicht, ohne eine Laufzeitüberprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um das Vorhandensein dieser Eigenschaft zu überprüfen, bevor Sie sie festlegen.

<ListView x:Name="listView1" Loaded="ListView_Loaded"/>

private void ListView_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.ListViewBase", "SingleSelectionFollowsFocus"))
    {
        listView1.SingleSelectionFollowsFocus = false;
    }
}

Gilt für:

Freigeben über