ListBox.SingleSelectionFollowsFocus Eigenschaft

Definition

Namespace:

Microsoft.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.

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 das fokussierte Element standardmäßig ebenfalls 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.

<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;
    }
}