ListViewItem.FindNearestItem(SearchDirectionHint) Método

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

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.ListViewItem

Public Function FindNearestItem (searchDirection As SearchDirectionHint) As ListViewItem

Parámetros

searchDirection: SearchDirectionHint

Uno de los valores de SearchDirectionHint.

Devoluciones

ListViewItem

ListViewItem más próximo a las coordenadas dadas para una búsqueda en la dirección especificada.

Excepciones

InvalidOperationException

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.

Se aplica a

Compartir a través de