ListBox.SelectedItem Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o item atualmente selecionado no ListBox.
public:
property System::Object ^ SelectedItem { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.Browsable(false)]
public object SelectedItem { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.Browsable(false)>]
member this.SelectedItem : obj with get, set
Public Property SelectedItem As Object
Valor de Propriedade
Um objeto que representa a seleção atual no controlo.
- Atributos
Exemplos
O exemplo de código seguinte demonstra como usar o SelectedIndexChanged evento para procurar e selecionar um item num controlo diferente ListBox . O exemplo usa o SelectedIndexChanged evento para determinar quando o item selecionado no ListBox é alterado. O código de exemplo lê então o texto do item usando a SelectedItem propriedade e chama o FindString método para outro ListBox usando o texto devolvido no SelectedItem primeiro ListBox. Se um item for encontrado no outro ListBox, o item é selecionado. Este exemplo exige que dois ListBox controlos, nomeados listBox1 e listBox2, tenham sido adicionados a um formulário e que ambos ListBox os controlos contenham itens idênticos. O exemplo também exige que o método de tratamento de eventos definido no exemplo esteja ligado ao SelectedIndexChanged evento de listBox1.
private:
void listBox1_SelectedIndexChanged( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Get the currently selected item in the ListBox.
String^ curItem = listBox1->SelectedItem->ToString();
// Find the string in ListBox2.
int index = listBox2->FindString( curItem );
// If the item was not found in ListBox 2 display a message box,
// otherwise select it in ListBox2.
if ( index == -1 )
MessageBox::Show( "Item is not available in ListBox2" );
else
listBox2->SetSelected( index, true );
}
private void listBox1_SelectedIndexChanged(object sender, System.EventArgs e)
{
// Get the currently selected item in the ListBox.
string curItem = listBox1.SelectedItem.ToString();
// Find the string in ListBox2.
int index = listBox2.FindString(curItem);
// If the item was not found in ListBox 2 display a message box, otherwise select it in ListBox2.
if(index == -1)
MessageBox.Show("Item is not available in ListBox2");
else
listBox2.SetSelected(index,true);
}
Private Sub listBox1_SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles listBox1.SelectedIndexChanged
' Get the currently selected item in the ListBox.
Dim curItem As String = listBox1.SelectedItem.ToString()
' Find the string in ListBox2.
Dim index As Integer = listBox2.FindString(curItem)
' If the item was not found in ListBox 2 display a message box, otherwise select it in ListBox2.
If index = -1 Then
MessageBox.Show("Item is not available in ListBox2")
Else
listBox2.SetSelected(index, True)
End If
End Sub
Observações
Para um padrão ListBox, pode usar esta propriedade para determinar qual o item selecionado no ListBox. Se a SelectionMode propriedade de o ListBox estiver definida como ou SelectionMode.MultiSimpleSelectionMode.MultiExtended (o que indica uma seleção ListBoxmúltipla ) e vários itens forem selecionados na lista, esta propriedade pode devolver qualquer item selecionado.
Para recuperar uma coleção contendo todos os itens selecionados numa seleção ListBoxmúltipla , use a SelectedItems propriedade. Se quiser obter a posição de índice do item atualmente selecionado no ListBox, use a SelectedIndex propriedade. Além disso, pode usar a SelectedIndices propriedade para obter todos os índices selecionados numa seleção ListBoxmúltipla .