Procedura: aggiungere funzionalità di ricerca a un controllo ListView
Quando si utilizza un elenco di elementi di grandi dimensioni in un controllo ListView, spesso è necessario fornire all'utente funzionalità di ricerca. Il controllo ListView offre tali funzionalità in due modi diversi, mediante corrispondenza del testo e mediante ricerca della posizione.
Il metodo FindItemWithText consente di eseguire una ricerca di testo in un controllo ListView in visualizzazione elenco o dettagli, in base a una stringa di ricerca e a indici di inizio e fine facoltativi. Il metodo FindNearestItem, invece, consente di trovare un elemento in un controllo ListView in visualizzazione a icone o affiancata, in base a un insieme di coordinate x e y e a una direzione di ricerca.
Per trovare un elemento utilizzando del testo
Creare un controllo ListView con la proprietà View impostata su Details o List, quindi compilare il controllo ListView con elementi.
Chiamare il metodo FindItemWithText, passando il testo dell'elemento che si desidera trovare.
Nell'esempio di codice riportato di seguito viene illustrato come creare un controllo ListView base, compilarlo con elementi e utilizzare testo immesso dall'utente per trovare un elemento nell'elenco.
Private textListView As New ListView()
Private WithEvents searchBox As New TextBox()
Private Sub InitializeTextSearchListView()
searchBox.Location = New Point(150, 20)
textListView.Scrollable = True
textListView.Width = 80
textListView.Height = 50
' Set the View to list to use the FindItemWithText method.
textListView.View = View.List
' Populate the ListView with items.
textListView.Items.AddRange(New ListViewItem() { _
New ListViewItem("Amy Alberts"), _
New ListViewItem("Amy Recker"), _
New ListViewItem("Erin Hagens"), _
New ListViewItem("Barry Johnson"), _
New ListViewItem("Jay Hamlin"), _
New ListViewItem("Brian Valentine"), _
New ListViewItem("Brian Welker"), _
New ListViewItem("Daniel Weisman")})
' Add the controls to the form.
Me.Controls.Add(textListView)
Me.Controls.Add(searchBox)
End Sub
Private Sub searchBox_TextChanged(ByVal sender As Object, ByVal e As EventArgs) _
Handles searchBox.TextChanged
' Call FindItemWithText with the contents of the textbox.
Dim foundItem As ListViewItem = _
textListView.FindItemWithText(searchBox.Text, False, 0, True)
If (foundItem IsNot Nothing) Then
textListView.TopItem = foundItem
End If
End Sub
private ListView textListView = new ListView();
private TextBox searchBox = new TextBox();
private void InitializeTextSearchListView()
{
searchBox.Location = new Point(10, 60);
textListView.Scrollable = true;
textListView.Width = 80;
textListView.Height = 50;
// Set the View to list to use the FindItemWithText method.
textListView.View = View.List;
// Populate the ListViewWithItems
textListView.Items.AddRange(new ListViewItem[]{
new ListViewItem("Amy Alberts"),
new ListViewItem("Amy Recker"),
new ListViewItem("Erin Hagens"),
new ListViewItem("Barry Johnson"),
new ListViewItem("Jay Hamlin"),
new ListViewItem("Brian Valentine"),
new ListViewItem("Brian Welker"),
new ListViewItem("Daniel Weisman") });
// Handle the TextChanged to get the text for our search.
searchBox.TextChanged += new EventHandler(searchBox_TextChanged);
// Add the controls to the form.
this.Controls.Add(textListView);
this.Controls.Add(searchBox);
}
private void searchBox_TextChanged(object sender, EventArgs e)
{
// Call FindItemWithText with the contents of the textbox.
ListViewItem foundItem =
textListView.FindItemWithText(searchBox.Text, false, 0, true);
if (foundItem != null)
{
textListView.TopItem = foundItem;
}
}
private:
ListView^ textListView;
TextBox^ searchBox;
private:
void InitializeTextSearchListView()
{
textListView = gcnew ListView();
searchBox = gcnew TextBox();
searchBox->Location = Point(150, 20);
textListView->Scrollable = true;
textListView->Width = 100;
// Set the View to list to use the FindItemWithText method.
textListView->View = View::List;
// Populate the ListViewWithItems
textListView->Items->AddRange(gcnew array<ListViewItem^>{
gcnew ListViewItem("Amy Alberts"),
gcnew ListViewItem("Amy Recker"),
gcnew ListViewItem("Erin Hagens"),
gcnew ListViewItem("Barry Johnson"),
gcnew ListViewItem("Jay Hamlin"),
gcnew ListViewItem("Brian Valentine"),
gcnew ListViewItem("Brian Welker"),
gcnew ListViewItem("Daniel Weisman") });
// Handle the TextChanged to get the text for our search.
searchBox->TextChanged += gcnew EventHandler(this,
&Form1::searchBox_TextChanged);
// Add the controls to the form.
this->Controls->Add(textListView);
this->Controls->Add(searchBox);
}
private:
void searchBox_TextChanged(Object^ sender, EventArgs^ e)
{
// Call FindItemWithText with the contents of the textbox.
ListViewItem^ foundItem =
textListView->FindItemWithText(searchBox->Text, false, 0, true);
if (foundItem != nullptr)
{
textListView->TopItem = foundItem;
}
}
Per trovare un elemento utilizzando le coordinate x e y
Creare un controllo ListView con la proprietà View impostata su SmallIcon o LargeIcon, quindi compilare il controllo ListView con elementi.
Chiamare il metodo FindNearestItem, passando le coordinate x e y desiderate e la direzione in cui eseguire la ricerca.
Nell'esempio di codice riportato di seguito viene illustrato come creare un controllo ListView base con visualizzazione a icone, compilarlo con elementi e acquisire l'evento MouseDown per trovare l'elemento in alto più vicino.
Private WithEvents iconListView As New ListView()
Private previousItemBox As New TextBox()
Private Sub InitializeLocationSearchListView()
previousItemBox.Location = New Point(150, 20)
' Create an image list for the icon ListView.
iconListView.LargeImageList = New ImageList()
' Add an image to the ListView large icon list.
iconListView.LargeImageList.Images.Add(New Bitmap(GetType(Control), "Edit.bmp"))
' Set the view to large icon and add some items with the image
' in the image list.
iconListView.View = View.SmallIcon
iconListView.Items.AddRange(New ListViewItem() { _
New ListViewItem("Amy Alberts", 0), _
New ListViewItem("Amy Recker", 0), _
New ListViewItem("Erin Hagens", 0), _
New ListViewItem("Barry Johnson", 0), _
New ListViewItem("Jay Hamlin", 0), _
New ListViewItem("Brian Valentine", 0), _
New ListViewItem("Brian Welker", 0), _
New ListViewItem("Daniel Weisman", 0)})
Me.Controls.Add(iconListView)
Me.Controls.Add(previousItemBox)
End Sub
Sub iconListView_MouseDown(ByVal sender As Object, ByVal e As MouseEventArgs) _
Handles iconListView.MouseDown
' Find the next item up from where the user clicked.
Dim foundItem As ListViewItem = _
iconListView.FindNearestItem(SearchDirectionHint.Up, e.X, e.Y)
' Display the results in a textbox.
If (foundItem IsNot Nothing) Then
previousItemBox.Text = foundItem.Text
Else
previousItemBox.Text = "No item found"
End If
End Sub
ListView iconListView = new ListView();
TextBox previousItemBox = new TextBox();
private void InitializeLocationSearchListView()
{
previousItemBox.Location = new Point(150, 20);
// Create an image list for the icon ListView.
iconListView.LargeImageList = new ImageList();
iconListView.Height = 400;
// Add an image to the ListView large icon list.
iconListView.LargeImageList.Images.Add(
new Bitmap(typeof(Control), "Edit.bmp"));
// Set the view to large icon and add some items with the image
// in the image list.
iconListView.View = View.LargeIcon;
iconListView.Items.AddRange(new ListViewItem[]{
new ListViewItem("Amy Alberts", 0),
new ListViewItem("Amy Recker", 0),
new ListViewItem("Erin Hagens", 0),
new ListViewItem("Barry Johnson", 0),
new ListViewItem("Jay Hamlin", 0),
new ListViewItem("Brian Valentine", 0),
new ListViewItem("Brian Welker", 0),
new ListViewItem("Daniel Weisman", 0) });
this.Controls.Add(iconListView);
this.Controls.Add(previousItemBox);
// Handle the MouseDown event to capture user input.
iconListView.MouseDown +=
new MouseEventHandler(iconListView_MouseDown);
//iconListView.MouseWheel += new MouseEventHandler(iconListView_MouseWheel);
}
void iconListView_MouseDown(object sender, MouseEventArgs e)
{
// Find the an item above where the user clicked.
ListViewItem foundItem =
iconListView.FindNearestItem(SearchDirectionHint.Up, e.X, e.Y);
// Display the results in a textbox..
if (foundItem != null)
previousItemBox.Text = foundItem.Text;
else
previousItemBox.Text = "No item found";
}
ListView^ iconListView;
TextBox^ previousItemBox;
private:
void InitializeLocationSearchListView()
{
previousItemBox = gcnew TextBox();
iconListView = gcnew ListView();
previousItemBox->Location = Point(150, 20);
// Create an image list for the icon ListView.
iconListView->SmallImageList = gcnew ImageList();
// Add an image to the ListView small icon list.
iconListView->SmallImageList->Images->Add(
gcnew Bitmap(Control::typeid, "Edit.bmp"));
// Set the view to small icon and add some items with the image
// in the image list.
iconListView->View = View::SmallIcon;
iconListView->Items->AddRange(gcnew array<ListViewItem^>{
gcnew ListViewItem("Amy Alberts", 0),
gcnew ListViewItem("Amy Recker", 0),
gcnew ListViewItem("Erin Hagens", 0),
gcnew ListViewItem("Barry Johnson", 0),
gcnew ListViewItem("Jay Hamlin", 0),
gcnew ListViewItem("Brian Valentine", 0),
gcnew ListViewItem("Brian Welker", 0),
gcnew ListViewItem("Daniel Weisman", 0) });
this->Controls->Add(iconListView);
this->Controls->Add(previousItemBox);
// Handle the MouseDown event to capture user input.
iconListView->MouseDown += gcnew MouseEventHandler(
this, &Form1::iconListView_MouseDown);
}
void iconListView_MouseDown(Object^ sender, MouseEventArgs^ e)
{
// Find the next item up from where the user clicked.
ListViewItem^ foundItem = iconListView->FindNearestItem(
SearchDirectionHint::Up, e->X, e->Y);
// Display the results in a textbox..
if (foundItem != nullptr)
{
previousItemBox->Text = foundItem->Text;
}
else
{
previousItemBox->Text = "No item found";
}
}
Vedere anche
Attività
Procedura: aggiungere e rimuovere elementi tramite il controllo ListView di Windows Form
Riferimenti
Cenni preliminari sul controllo ListView (Windows Form)