ListViewInsertionMark.NearestIndex(Point) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ListViewInsertionMark.cs

Načte index položky, která je nejblíže zadanému bodu.

public:
 int NearestIndex(System::Drawing::Point pt);

public int NearestIndex (System.Drawing.Point pt);

member this.NearestIndex : System.Drawing.Point -> int

Public Function NearestIndex (pt As Point) As Integer

Parametry

pt

Point

A Point představující umístění, ze kterého se má najít nejbližší položka.

Návraty

Int32

Index položky nejblíže zadanému bodu nebo -1, pokud je nejbližší položka právě přetahovaná položka.

Příklady

Následující příklad kódu ukazuje, jak používat funkci kurzoru ListView a implementuje změnu pořadí položek přetažením pomocí standardních událostí přetažení. Pozice značky vložení se aktualizuje v obslužné rutině Control.DragOver události. V této obslužné rutině je pozice ukazatele myši porovnána se středem nejbližší položky a výsledek se používá k určení, zda se značka vložení zobrazí vlevo nebo vpravo od položky.

Úplný příklad najdete v tématu s referenčními informacemi o přehledu ListViewInsertionMark .

// Moves the insertion mark as the item is dragged.
void myListView_DragOver( Object^ /*sender*/, DragEventArgs^ e )
{
   // Retrieve the client coordinates of the mouse pointer.
   Point targetPoint = myListView->PointToClient( Point(e->X,e->Y) );

   // Retrieve the index of the item closest to the mouse pointer.
   int targetIndex = myListView->InsertionMark->NearestIndex( targetPoint );

   // Confirm that the mouse pointer is not over the dragged item.
   if ( targetIndex > -1 )
   {
      // Determine whether the mouse pointer is to the left or
      // the right of the midpoint of the closest item and set
      // the InsertionMark.AppearsAfterItem property accordingly.
      Rectangle itemBounds = myListView->GetItemRect( targetIndex );
      if ( targetPoint.X > itemBounds.Left + (itemBounds.Width / 2) )
      {
         myListView->InsertionMark->AppearsAfterItem = true;
      }
      else
      {
         myListView->InsertionMark->AppearsAfterItem = false;
      }
   }

   // Set the location of the insertion mark. If the mouse is
   // over the dragged item, the targetIndex value is -1 and
   // the insertion mark disappears.
   myListView->InsertionMark->Index = targetIndex;
}

// Moves the insertion mark as the item is dragged.
private void myListView_DragOver(object sender, DragEventArgs e)
{
    // Retrieve the client coordinates of the mouse pointer.
    Point targetPoint = 
        myListView.PointToClient(new Point(e.X, e.Y));

    // Retrieve the index of the item closest to the mouse pointer.
    int targetIndex = myListView.InsertionMark.NearestIndex(targetPoint);

    // Confirm that the mouse pointer is not over the dragged item.
    if (targetIndex > -1) 
    {
        // Determine whether the mouse pointer is to the left or
        // the right of the midpoint of the closest item and set
        // the InsertionMark.AppearsAfterItem property accordingly.
        Rectangle itemBounds = myListView.GetItemRect(targetIndex);
        if ( targetPoint.X > itemBounds.Left + (itemBounds.Width / 2) )
        {
            myListView.InsertionMark.AppearsAfterItem = true;
        }
        else
        {
            myListView.InsertionMark.AppearsAfterItem = false;
        }
    }

    // Set the location of the insertion mark. If the mouse is
    // over the dragged item, the targetIndex value is -1 and
    // the insertion mark disappears.
    myListView.InsertionMark.Index = targetIndex;
}

' Moves the insertion mark as the item is dragged.
Private Sub myListView_DragOver(sender As Object, e As DragEventArgs)
    ' Retrieve the client coordinates of the mouse pointer.
    Dim targetPoint As Point = myListView.PointToClient(New Point(e.X, e.Y))
    
    ' Retrieve the index of the item closest to the mouse pointer.
    Dim targetIndex As Integer = _
        myListView.InsertionMark.NearestIndex(targetPoint)
    
    ' Confirm that the mouse pointer is not over the dragged item.
    If targetIndex > -1 Then
        ' Determine whether the mouse pointer is to the left or
        ' the right of the midpoint of the closest item and set
        ' the InsertionMark.AppearsAfterItem property accordingly.
        Dim itemBounds As Rectangle = myListView.GetItemRect(targetIndex)
        If targetPoint.X > itemBounds.Left + (itemBounds.Width / 2) Then
            myListView.InsertionMark.AppearsAfterItem = True
        Else
            myListView.InsertionMark.AppearsAfterItem = False
        End If
    End If
    
    ' Set the location of the insertion mark. If the mouse is
    ' over the dragged item, the targetIndex value is -1 and
    ' the insertion mark disappears.
    myListView.InsertionMark.Index = targetIndex
End Sub

Poznámky

Tato metoda umožňuje při provádění operace přetažení vyhledat položku, která je nejblíže ukazateli myši. K nastavení vlastnosti použijte vrácenou hodnotu indexu Index . Pokud je položka, která je nejblíže ukazateli myši, je přetahovaná položka, návratová hodnota této metody je -1. V tomto případě nastavení Index vlastnosti na tuto hodnotu skryje značku vložení.

Tato metoda najde nejbližší položku bez ohledu na to, kde je umístěn ukazatel myši, zatímco ListView.GetItemAt metoda vrátí položku pouze v zadaném umístění, nebo null pokud na tomto místě není žádná položka. Metoda ListView.GetItemAt vrátí null, například když je ukazatel myši umístěn mezi dvěma položkami. Z tohoto důvodu byste při použití operace přetažení k umístění položek měli vždy používat metodu NearestIndex .

Viz také

• ListView