ListBox.SingleSelectionFollowsFocus Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define um valor que indica se a seleção de item muda quando o foco do teclado é alterado.

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 da propriedade

Boolean

bool

true se a seleção de item for alterada quando o foco do teclado for alterado; caso contrário, false. O padrão é true.

Requisitos do Windows

Família de dispositivos	Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v3.0)

Comentários

Essa propriedade será ignorada se a propriedade SelectionMode da caixa de listagem não estiver definida como Single.

Por padrão, quando uma caixa de listagem é configurada para seleção única, quando o usuário move o foco do teclado para um item, o item focado também é selecionado. Por exemplo, se o foco do teclado for movido do primeiro item para o segundo item, a propriedade SelectedIndex será atualizada de 0 para 1.

Defina essa propriedade como false para permitir que um usuário mova o foco sem a seleção de item a seguir. Por exemplo, se cada alteração de seleção causar atualizações significativas da interface do usuário, talvez você prefira permitir que o usuário mova o foco para um item não adjacente e pressione Enter para atualizar a seleção.

Compatibilidade de versões

A propriedade SingleSelectionFollowsFocus não está disponível antes do Windows 10, versão 1607. Se a configuração de "versão mínima da plataforma" do seu aplicativo no Microsoft Visual Studio for menor do que a "versão introduzida" mostrada no bloco Requisitos mais adiante nesta página, você deverá projetar e testar seu aplicativo para considerar isso. Para obter mais informações, consulte Código adaptável de versão.

Para evitar exceções quando seu aplicativo é executado em versões anteriores do Windows 10, não defina essa propriedade em XAML nem use-a sem executar um runtime marcar. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença dessa propriedade antes de defini-la.

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