ListViewBase.SingleSelectionFollowsFocus Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

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.

Windows-Anforderungen

Gerätefamilie	Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

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 beispielsweise jede Auswahländerung zu erheblichen Ui-Updates führt, sollten Sie es dem Benutzer vorziehen, 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 ist als die "eingeführte Version", die im Block Anforderungen weiter unten auf dieser Seite angezeigt wird, müssen Sie Ihre App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Adaptiver Versionscode.

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 Laufzeitprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um zu überprüfen, ob diese Eigenschaft vorhanden ist, 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;
    }
}