ListViewBase.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 = listViewBase.singleSelectionFollowsFocus;
listViewBase.singleSelectionFollowsFocus = boolean;

Public Property SingleSelectionFollowsFocus As Boolean

<listViewBase 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 exibição de lista não estiver definida como Single.

Por padrão, quando uma exibição de lista é 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.

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