ListViewItem.Selected 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 o item está selecionado.
public:
property bool Selected { bool get(); void set(bool value); };[System.ComponentModel.Browsable(false)]
public bool Selected { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.Selected : bool with get, setPublic Property Selected As BooleanValor da propriedade
true se o item estiver selecionado; caso contrário, false.
- Atributos
Exemplos
O exemplo de código a seguir demonstra como usar os ListView.Clear membros e Selected . Para executar o exemplo, coloque o código a seguir em um formulário que contém um ListView nomeado e um Button, localizados na parte inferior do formulário, chamado Button1ListView1 . Chame o InitializeListView método do construtor do formulário ou Load do método de manipulação de eventos.
private:
void InitializeListView()
{
// Set up the inital values for the ListView and populate it.
this->ListView1 = gcnew ListView;
this->ListView1->Dock = DockStyle::Top;
this->ListView1->Location = System::Drawing::Point( 0, 0 );
this->ListView1->Size = System::Drawing::Size( 292, 130 );
this->ListView1->View = View::Details;
this->ListView1->FullRowSelect = true;
array<String^>^breakfast = {"Continental Breakfast","Pancakes and Sausage","Denver Omelet","Eggs & Bacon","Bagel & Cream Cheese"};
array<String^>^breakfastPrices = {"3.09","4.09","4.19","4.79","2.09"};
PopulateMenu( "Breakfast", breakfast, breakfastPrices );
}
void PopulateMenu( String^ meal, array<String^>^menuItems, array<String^>^menuPrices )
{
ColumnHeader^ columnHeader1 = gcnew ColumnHeader;
columnHeader1->Text = String::Concat( meal, " Choices" );
columnHeader1->TextAlign = HorizontalAlignment::Left;
columnHeader1->Width = 146;
ColumnHeader^ columnHeader2 = gcnew ColumnHeader;
columnHeader2->Text = "Price";
columnHeader2->TextAlign = HorizontalAlignment::Center;
columnHeader2->Width = 142;
this->ListView1->Columns->Add( columnHeader1 );
this->ListView1->Columns->Add( columnHeader2 );
for ( int count = 0; count < menuItems->Length; count++ )
{
ListViewItem^ listItem = gcnew ListViewItem( menuItems[ count ] );
listItem->SubItems->Add( menuPrices[ count ] );
ListView1->Items->Add( listItem );
}
// Use the Selected property to select the first item on
// the list.
ListView1->Focus();
ListView1->Items[ 0 ]->Selected = true;
}
void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Create new values for the ListView, clear the list,
// and repopulate it.
array<String^>^lunch = {"Hamburger","Grilled Cheese","Soup & Salad","Club Sandwich","Hotdog"};
array<String^>^lunchPrices = {"4.09","5.09","5.19","4.79","2.09"};
ListView1->Clear();
PopulateMenu( "Lunch", lunch, lunchPrices );
Button1->Enabled = false;
}
private void InitializeListView()
{
// Set up the inital values for the ListView and populate it.
this.ListView1 = new ListView();
this.ListView1.Dock = DockStyle.Top;
this.ListView1.Location = new System.Drawing.Point(0, 0);
this.ListView1.Size = new System.Drawing.Size(292, 130);
this.ListView1.View = View.Details;
this.ListView1.FullRowSelect = true;
string[] breakfast = new string[]{"Continental Breakfast",
"Pancakes and Sausage", "Denver Omelet", "Eggs & Bacon",
"Bagel & Cream Cheese"};
string[] breakfastPrices = new string[]{"3.09", "4.09",
"4.19", "4.79", "2.09"};
PopulateMenu("Breakfast", breakfast, breakfastPrices);
}
private void PopulateMenu(string meal,
string[] menuItems, string[] menuPrices)
{
ColumnHeader columnHeader1 = new ColumnHeader();
columnHeader1.Text = meal + " Choices";
columnHeader1.TextAlign = HorizontalAlignment.Left;
columnHeader1.Width = 146;
ColumnHeader columnHeader2 = new ColumnHeader();
columnHeader2.Text = "Price";
columnHeader2.TextAlign = HorizontalAlignment.Center;
columnHeader2.Width = 142;
this.ListView1.Columns.Add(columnHeader1);
this.ListView1.Columns.Add(columnHeader2);
for(int count=0; count < menuItems.Length; count++)
{
ListViewItem listItem =
new ListViewItem(menuItems[count]);
listItem.SubItems.Add(menuPrices[count]);
ListView1.Items.Add(listItem);
}
// Use the Selected property to select the first item on
// the list.
ListView1.Focus();
ListView1.Items[0].Selected = true;
}
private void Button1_Click(System.Object sender, System.EventArgs e)
{
// Create new values for the ListView, clear the list,
// and repopulate it.
string[] lunch = new string[]{"Hamburger", "Grilled Cheese",
"Soup & Salad", "Club Sandwich", "Hotdog"};
string[] lunchPrices = new string[]{"4.09", "5.09", "5.19",
"4.79", "2.09"};
ListView1.Clear();
PopulateMenu("Lunch", lunch, lunchPrices);
Button1.Enabled = false;
}
Private Sub InitializeListView()
' Set up the inital values for the ListView and populate it.
Me.ListView1 = New ListView
Me.ListView1.Dock = DockStyle.Top
Me.ListView1.Location = New System.Drawing.Point(0, 0)
Me.ListView1.Size = New System.Drawing.Size(292, 130)
Me.ListView1.View = View.Details
Me.ListView1.FullRowSelect = True
Dim breakfast() As String = New String() {"Continental Breakfast", "Pancakes and Sausage", _
"Denver Omelet", "Eggs & Bacon", "Bagel & Cream Cheese"}
Dim breakfastPrices() As String = New String() {"3.09", "4.09", "4.19", _
"4.79", "2.09"}
PopulateMenu("Breakfast", breakfast, breakfastPrices)
End Sub
Private Sub PopulateMenu(ByVal meal As String, _
ByVal menuItems() As String, ByVal menuPrices() As String)
Dim columnHeader1 As New ColumnHeader
With columnHeader1
.Text = meal & " Choices"
.TextAlign = HorizontalAlignment.Left
.Width = 146
End With
Dim columnHeader2 As New ColumnHeader
With columnHeader2
.Text = "Price"
.TextAlign = HorizontalAlignment.Center
.Width = 142
End With
Me.ListView1.Columns.Add(columnHeader1)
Me.ListView1.Columns.Add(columnHeader2)
Dim count As Integer
For count = 0 To menuItems.Length - 1
Dim listItem As New ListViewItem(menuItems(count))
listItem.SubItems.Add(menuPrices(count))
ListView1.Items.Add(listItem)
Next
' Use the Selected property to select the first item on
' the list.
ListView1.Focus()
ListView1.Items(0).Selected = True
End Sub
Private Sub Button1_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
' Create new values for the ListView, clear the list,
' and repopulate it.
Dim lunch() As String = New String() {"Hamburger", _
"Grilled Cheese", "Soup & Salad", "Club Sandwich", "Hotdog"}
Dim lunchPrices() As String = New String() {"4.09", "5.09", _
"5.19", "4.79", "2.09"}
ListView1.Clear()
PopulateMenu("Lunch", lunch, lunchPrices)
Button1.Enabled = False
End Sub
Comentários
Se a MultiSelect propriedade do ListView controle em que o item está contido estiver definida truecomo , definir o valor dessa propriedade adicionará ou removerá o item do conjunto de itens selecionados. Se a MultiSelect propriedade for definida falsecomo , definir o valor dessa propriedade para selecionar um item cancelará automaticamente a seleção de outros itens no ListView controle. Você pode usar essa propriedade para determinar se um item está selecionado ou selecionar um item em tempo de execução. Você pode acessar todos os itens selecionados em um ListView controle usando a ListView.SelectedItems propriedade .
Observação
Os itens aparecem selecionados somente quando o ListView controle tem foco. Para selecionar itens em resposta a uma ação do usuário, como um clique de botão, chame o Focus método além de definir essa propriedade.
