ListViewBase.SingleSelectionFollowsFocus Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Obtém ou define um valor que indica se a seleção de itens 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 = listViewBase.singleSelectionFollowsFocus;
listViewBase.singleSelectionFollowsFocus = boolean;

Public Property SingleSelectionFollowsFocus As Boolean

<listViewBase SingleSelectionFollowsFocus="bool" />

Valor da propriedade

Boolean

bool

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

Comentários

Essa propriedade será ignorada se a propriedade SelectionMode do modo de exibição de lista não estiver definida como Single.

Por padrão, quando um modo de exibição de lista é configurado para seleção única, quando o usuário move o foco do teclado para um item, o item focalizado 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 que a "versão introduzida" mostrada no bloco Requisitos posteriormente 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.

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