ListBox.SingleSelectionFollowsFocus Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 = listBox.singleSelectionFollowsFocus;
listBox.singleSelectionFollowsFocus = boolean;
Public Property SingleSelectionFollowsFocus As Boolean
<ListBox SingleSelectionFollowsFocus="bool" />
Valor da propriedade
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 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 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.
<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;
}
}