ListBox.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 = listBox.singleSelectionFollowsFocus;
listBox.singleSelectionFollowsFocus = boolean;

Public Property SingleSelectionFollowsFocus As Boolean

<ListBox 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 des Listenfelds nicht auf Single festgelegt ist.

Wenn ein Listenfeld 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.

<ListBox x:Name="listBox1" Loaded="ListBox_Loaded"/>

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