ListBox.SingleSelectionFollowsFocus Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Obtiene o establece un valor que indica si cambia la selección de elementos cuando cambia el foco del teclado.

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" />

Valor de propiedad

Boolean

bool

true si cambia la selección de elementos cuando cambia el foco del teclado; de lo contrario, false. El valor predeterminado es true.

Requisitos de Windows

Familia de dispositivos	Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Comentarios

Esta propiedad se omite si la propiedad SelectionMode del cuadro de lista no está establecida en Single.

De forma predeterminada, cuando se configura un cuadro de lista para una sola selección, cuando el usuario mueve el foco del teclado a un elemento, también se selecciona el elemento centrado. Por ejemplo, si el foco del teclado se mueve del primer elemento al segundo elemento, la propiedad SelectedIndex se actualiza de 0 a 1.

Establezca esta propiedad en false para permitir que un usuario mueva el foco sin la selección de elementos siguiente. Por ejemplo, si cada cambio de selección provoca actualizaciones significativas de la interfaz de usuario, es posible que prefiera permitir que el usuario mueva el foco a un elemento no adyacente y, a continuación, presione Entrar para actualizar la selección.

Compatibilidad de versiones

La propiedad SingleSelectionFollowsFocus no está disponible antes de Windows 10, versión 1607. Si la configuración "versión mínima de la plataforma" de la aplicación en Microsoft Visual Studio es menor que la "versión introducida" que se muestra en el bloque Requisitos más adelante en esta página, debe diseñar y probar la aplicación para tener en cuenta esto. Para obtener más información, consulta Código adaptable de versión.

Para evitar excepciones cuando la aplicación se ejecute en versiones anteriores de Windows 10, no establezca esta propiedad en XAML ni úsela sin realizar una comprobación en tiempo de ejecución. En este ejemplo se muestra cómo usar la clase ApiInformation para comprobar la presencia de esta propiedad antes de establecerla.

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