ListViewBase.SingleSelectionFollowsFocus Eigenschaft
Definition
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.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob sich die Elementauswahl ändert, wenn sich der Tastaturfokus ändert.
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
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 eine einzelne Auswahl konfiguriert ist, wird das fokussierte Element ebenfalls ausgewählt, wenn der Benutzer den Tastaturfokus auf ein Element verschiebt. Wenn beispielsweise der Tastaturfokus vom ersten Element in 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 jede Auswahl beispielsweise erhebliche UI-Aktualisierungen verursacht, sollten Sie es dem Benutzer vorziehen, den Fokus auf ein nicht angrenzendes Element zu verschieben, und drücken Sie dann die EINGABETASTE, 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 Anforderungsblock weiter unten auf dieser Seite angezeigte "Eingeführte Version" ist, müssen Sie Ihre App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter versionsadaptiven 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 mithilfe der ApiInformation-Klasse ü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;
}
}