ListViewItem.FindNearestItem(SearchDirectionHint) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Encuentra el siguiente elemento a partir de ListViewItem, buscando en la dirección especificada.
public:
System::Windows::Forms::ListViewItem ^ FindNearestItem(System::Windows::Forms::SearchDirectionHint searchDirection);public System.Windows.Forms.ListViewItem FindNearestItem (System.Windows.Forms.SearchDirectionHint searchDirection);public System.Windows.Forms.ListViewItem? FindNearestItem (System.Windows.Forms.SearchDirectionHint searchDirection);member this.FindNearestItem : System.Windows.Forms.SearchDirectionHint -> System.Windows.Forms.ListViewItemPublic Function FindNearestItem (searchDirection As SearchDirectionHint) As ListViewItemParámetros
- searchDirection
- SearchDirectionHint
Uno de los valores de SearchDirectionHint.
Devoluciones
ListViewItem más próximo a las coordenadas dadas para una búsqueda en la dirección especificada.
Excepciones
La propiedad View del ListView que contiene se establece en un valor distinto de SmallIcon o LargeIcon.
Ejemplos
En el ejemplo de código siguiente se muestra cómo utilizar el método FindNearestItem. Para ejecutar este ejemplo, pegue el código siguiente en un formulario Windows Forms que contenga un ListView denominado findListView. Asegúrese de que la View propiedad está establecida en una vista de icono y que ListView se rellena con elementos. Asocie el MouseDown evento de findListView con el findListView_MouseDown método en este ejemplo.
void findListView_MouseDown(object sender, MouseEventArgs e)
{
ListViewHitTestInfo info = findListView.HitTest(e.X, e.Y);
ListViewItem foundItem = null;
if (info.Item != null)
foundItem = info.Item.FindNearestItem(SearchDirectionHint.Up);
if (foundItem != null)
label1.Text = "Previous Item: " + foundItem.Text;
else
label1.Text = "No item found";
}
Private Sub findListView_MouseDown(ByVal sender As Object, ByVal e As MouseEventArgs)
Dim info As ListViewHitTestInfo = findListView.HitTest(e.X, e.Y)
Dim foundItem As ListViewItem = Nothing
If (info.Item IsNot Nothing) Then
foundItem = info.Item.FindNearestItem(SearchDirectionHint.Up)
End If
If (foundItem IsNot Nothing) Then
label1.Text = "Previous Item: " + foundItem.Text
Else
label1.Text = "No item found"
End If
End Sub
Comentarios
El FindNearestItem método devuelve null si no se encuentra ningún elemento en la dirección especificada.
La identificación del elemento más cercano puede variar en función del sistema operativo en el que se ejecuta la aplicación y afectará a los resultados de FindNearestItem.
