ListViewInsertionMark 클래스

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

ListViewInsertionMark.cs

항목이 컨트롤의 새 위치로 끌 때 예상되는 놓기 위치를 ListView 나타내는 데 사용됩니다. 이 기능은 Windows XP 이상에서만 사용할 수 있습니다.

public ref class ListViewInsertionMark sealed

public sealed class ListViewInsertionMark

type ListViewInsertionMark = class

Public NotInheritable Class ListViewInsertionMark

상속

Object

ListViewInsertionMark

예제

다음 코드 예제에서는 삽입 표시 기능을 사용 ListView 하는 방법을 보여 줍니다 및 표준 끌기 이벤트를 사용 하 여 끌어서 놓기 항목 다시 정렬을 구현 합니다. 삽입 표시의 위치는 이벤트에 대한 처리기에서 업데이트됩니다 Control.DragOver . 이 처리기에서 마우스 포인터의 위치는 가장 가까운 항목의 중간점과 비교되며, 결과는 삽입 표시가 항목의 왼쪽 또는 오른쪽에 표시되는지 여부를 결정하는 데 사용됩니다.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class ListViewInsertionMarkExample: public Form
{
private:
   ListView^ myListView;

public:

   ListViewInsertionMarkExample()
   {
      // Initialize myListView.
      myListView = gcnew ListView;
      myListView->Dock = DockStyle::Fill;
      myListView->View = View::LargeIcon;
      myListView->MultiSelect = false;
      myListView->ListViewItemSorter = gcnew ListViewIndexComparer;

      // Initialize the insertion mark.
      myListView->InsertionMark->Color = Color::Green;

      // Add items to myListView.
      myListView->Items->Add( "zero" );
      myListView->Items->Add( "one" );
      myListView->Items->Add( "two" );
      myListView->Items->Add( "three" );
      myListView->Items->Add( "four" );
      myListView->Items->Add( "five" );

      // Initialize the drag-and-drop operation when running
      // under Windows XP or a later operating system.
      if ( System::Environment::OSVersion->Version->Major > 5 || (System::Environment::OSVersion->Version->Major == 5 && System::Environment::OSVersion->Version->Minor >= 1) )
      {
         myListView->AllowDrop = true;
         myListView->ItemDrag += gcnew ItemDragEventHandler( this, &ListViewInsertionMarkExample::myListView_ItemDrag );
         myListView->DragEnter += gcnew DragEventHandler( this, &ListViewInsertionMarkExample::myListView_DragEnter );
         myListView->DragOver += gcnew DragEventHandler( this, &ListViewInsertionMarkExample::myListView_DragOver );
         myListView->DragLeave += gcnew EventHandler( this, &ListViewInsertionMarkExample::myListView_DragLeave );
         myListView->DragDrop += gcnew DragEventHandler( this, &ListViewInsertionMarkExample::myListView_DragDrop );
      }

      // Initialize the form.
      this->Text = "ListView Insertion Mark Example";
      this->Controls->Add( myListView );
   }

private:

   // Starts the drag-and-drop operation when an item is dragged.
   void myListView_ItemDrag( Object^ /*sender*/, ItemDragEventArgs^ e )
   {
      myListView->DoDragDrop( e->Item, DragDropEffects::Move );
   }

   // Sets the target drop effect.
   void myListView_DragEnter( Object^ /*sender*/, DragEventArgs^ e )
   {
      e->Effect = e->AllowedEffect;
   }

   // 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;
   }

   // Removes the insertion mark when the mouse leaves the control.
   void myListView_DragLeave( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      myListView->InsertionMark->Index = -1;
   }

   // Moves the item to the location of the insertion mark.
   void myListView_DragDrop( Object^ /*sender*/, DragEventArgs^ e )
   {
      // Retrieve the index of the insertion mark;
      int targetIndex = myListView->InsertionMark->Index;

      // If the insertion mark is not visible, exit the method.
      if ( targetIndex == -1 )
      {
         return;
      }

      // If the insertion mark is to the right of the item with
      // the corresponding index, increment the target index.
      if ( myListView->InsertionMark->AppearsAfterItem )
      {
         targetIndex++;
      }

      // Retrieve the dragged item.
      ListViewItem^ draggedItem = dynamic_cast<ListViewItem^>(e->Data->GetData( ListViewItem::typeid ));

      // Insert a copy of the dragged item at the target index.
      // A copy must be inserted before the original item is removed
      // to preserve item index values.
      myListView->Items->Insert( targetIndex, dynamic_cast<ListViewItem^>(draggedItem->Clone()) );

      // Remove the original copy of the dragged item.
      myListView->Items->Remove( draggedItem );

   }

   // Sorts ListViewItem objects by index.
   ref class ListViewIndexComparer: public System::Collections::IComparer
   {
   public:
      virtual int Compare( Object^ x, Object^ y )
      {
         return (dynamic_cast<ListViewItem^>(x))->Index - (dynamic_cast<ListViewItem^>(y))->Index;
      }
   };
};

[STAThread]
int main()
{
   Application::EnableVisualStyles();
   Application::Run( gcnew ListViewInsertionMarkExample );
}

using System;
using System.Drawing;
using System.Windows.Forms;

public class ListViewInsertionMarkExample : Form
{
    private ListView myListView; 

    public ListViewInsertionMarkExample()
    {
        // Initialize myListView.
        myListView = new ListView();
        myListView.Dock = DockStyle.Fill;
        myListView.View = View.LargeIcon;
        myListView.MultiSelect = false;
        myListView.ListViewItemSorter = new ListViewIndexComparer();

        // Initialize the insertion mark.
        myListView.InsertionMark.Color = Color.Green;

        // Add items to myListView.
        myListView.Items.Add("zero");
        myListView.Items.Add("one");
        myListView.Items.Add("two");
        myListView.Items.Add("three");
        myListView.Items.Add("four");
        myListView.Items.Add("five");
        
        // Initialize the drag-and-drop operation when running
        // under Windows XP or a later operating system.
        if (OSFeature.Feature.IsPresent(OSFeature.Themes))
        {
            myListView.AllowDrop = true;
            myListView.ItemDrag += new ItemDragEventHandler(myListView_ItemDrag);
            myListView.DragEnter += new DragEventHandler(myListView_DragEnter);
            myListView.DragOver += new DragEventHandler(myListView_DragOver);
            myListView.DragLeave += new EventHandler(myListView_DragLeave);
            myListView.DragDrop += new DragEventHandler(myListView_DragDrop);
        }

        // Initialize the form.
        this.Text = "ListView Insertion Mark Example";
        this.Controls.Add(myListView);
    }

    [STAThread]
    static void Main() 
    {
        Application.EnableVisualStyles();
        Application.Run(new ListViewInsertionMarkExample());
    }

    // Starts the drag-and-drop operation when an item is dragged.
    private void myListView_ItemDrag(object sender, ItemDragEventArgs e)
    {
        myListView.DoDragDrop(e.Item, DragDropEffects.Move);
    }

    // Sets the target drop effect.
    private void myListView_DragEnter(object sender, DragEventArgs e)
    {
        e.Effect = e.AllowedEffect;
    }

    // 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;
    }

    // Removes the insertion mark when the mouse leaves the control.
    private void myListView_DragLeave(object sender, EventArgs e)
    {
        myListView.InsertionMark.Index = -1;
    }

    // Moves the item to the location of the insertion mark.
    private void myListView_DragDrop(object sender, DragEventArgs e)
    {
        // Retrieve the index of the insertion mark;
        int targetIndex = myListView.InsertionMark.Index;

        // If the insertion mark is not visible, exit the method.
        if (targetIndex == -1) 
        {
            return;
        }

        // If the insertion mark is to the right of the item with
        // the corresponding index, increment the target index.
        if (myListView.InsertionMark.AppearsAfterItem) 
        {
            targetIndex++;
        }

        // Retrieve the dragged item.
        ListViewItem draggedItem = 
            (ListViewItem)e.Data.GetData(typeof(ListViewItem));

        // Insert a copy of the dragged item at the target index.
        // A copy must be inserted before the original item is removed
        // to preserve item index values. 
        myListView.Items.Insert(
            targetIndex, (ListViewItem)draggedItem.Clone());

        // Remove the original copy of the dragged item.
        myListView.Items.Remove(draggedItem);
    }

    // Sorts ListViewItem objects by index.
    private class ListViewIndexComparer : System.Collections.IComparer
    {
        public int Compare(object x, object y)
        {
            return ((ListViewItem)x).Index - ((ListViewItem)y).Index;
        }
    }
}

Imports System.Drawing
Imports System.Windows.Forms

Public Class ListViewInsertionMarkExample
    Inherits Form

    Private myListView As ListView
    
    Public Sub New()
        ' Initialize myListView.
        myListView = New ListView()
        myListView.Dock = DockStyle.Fill
        myListView.View = View.LargeIcon
        myListView.MultiSelect = False
        myListView.ListViewItemSorter = New ListViewIndexComparer()
        
        ' Initialize the insertion mark.
        myListView.InsertionMark.Color = Color.Green
        
        ' Add items to myListView.
        myListView.Items.Add("zero")
        myListView.Items.Add("one")
        myListView.Items.Add("two")
        myListView.Items.Add("three")
        myListView.Items.Add("four")
        myListView.Items.Add("five")
        
        ' Initialize the drag-and-drop operation when running
        ' under Windows XP or a later operating system.
        If OSFeature.Feature.IsPresent(OSFeature.Themes)
            myListView.AllowDrop = True
            AddHandler myListView.ItemDrag, AddressOf myListView_ItemDrag
            AddHandler myListView.DragEnter, AddressOf myListView_DragEnter
            AddHandler myListView.DragOver, AddressOf myListView_DragOver
            AddHandler myListView.DragLeave, AddressOf myListView_DragLeave
            AddHandler myListView.DragDrop, AddressOf myListView_DragDrop
        End If 

        ' Initialize the form.
        Me.Text = "ListView Insertion Mark Example"
        Me.Controls.Add(myListView)
    End Sub

    <STAThread()> _
    Shared Sub Main()
        Application.EnableVisualStyles()
        Application.Run(New ListViewInsertionMarkExample())
    End Sub
    
    ' Starts the drag-and-drop operation when an item is dragged.
    Private Sub myListView_ItemDrag(sender As Object, e As ItemDragEventArgs)
        myListView.DoDragDrop(e.Item, DragDropEffects.Move)
    End Sub
    
    ' Sets the target drop effect.
    Private Sub myListView_DragEnter(sender As Object, e As DragEventArgs)
        e.Effect = e.AllowedEffect
    End Sub
    
    ' 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

    ' Removes the insertion mark when the mouse leaves the control.
    Private Sub myListView_DragLeave(sender As Object, e As EventArgs)
        myListView.InsertionMark.Index = -1
    End Sub
    
    ' Moves the item to the location of the insertion mark.
    Private Sub myListView_DragDrop(sender As Object, e As DragEventArgs)
        ' Retrieve the index of the insertion mark;
        Dim targetIndex As Integer = myListView.InsertionMark.Index
        
        ' If the insertion mark is not visible, exit the method.
        If targetIndex = -1 Then
            Return
        End If 

        ' If the insertion mark is to the right of the item with
        ' the corresponding index, increment the target index.
        If myListView.InsertionMark.AppearsAfterItem Then
            targetIndex += 1
        End If 

        ' Retrieve the dragged item.
        Dim draggedItem As ListViewItem = _
            CType(e.Data.GetData(GetType(ListViewItem)), ListViewItem)
        
        ' Insert a copy of the dragged item at the target index.
        ' A copy must be inserted before the original item is removed
        ' to preserve item index values.
        myListView.Items.Insert(targetIndex, _
            CType(draggedItem.Clone(), ListViewItem))
        
        ' Remove the original copy of the dragged item.
        myListView.Items.Remove(draggedItem)

    End Sub
    
    ' Sorts ListViewItem objects by index.    
    Private Class ListViewIndexComparer
        Implements System.Collections.IComparer
        
        Public Function Compare(x As Object, y As Object) As Integer _
            Implements System.Collections.IComparer.Compare
            Return CType(x, ListViewItem).Index - CType(y, ListViewItem).Index
        End Function 'Compare

    End Class

End Class

설명

컨트롤의 속성에서 InsertionMark 검색하여 항목을 새 위치로 ListView 끌 때 끌어서 놓기 작업에서 예상되는 놓기 위치를 시각적으로 나타낼 수 ListViewInsertionMark 있습니다.

이 기능은 속성이 ListView.AutoArrange 설정 true 되고 컨트롤이 ListView 항목을 자동으로 정렬하지 않는 경우에만 작동합니다. 자동 정렬을 ListView.Sorting 방지하려면 속성을 설정 SortOrder.None 해야 하며 속성은 ListView.View 또는 View.SmallIconView.Tile.로 View.LargeIcon설정해야 합니다. 또한 그룹화 기능은 그룹 멤버 자격별로 항목을 정렬하므로 삽입 표시 기능을 그룹화 기능과 함께 ListView 사용할 수 없습니다.

ListViewInsertionMark 클래스는 일반적으로 항목이 끌기로 삽입 표시의 위치를 업데이트 하는 또는 Control.MouseMove 이벤트에 대 Control.DragOver 한 처리기에서 사용 합니다. 또한 올바른 위치에 끌어진 항목을 삽입하는 이벤트 또는 Control.MouseUp 이벤트에 대한 Control.DragDrop 처리기에서도 사용됩니다.

삽입 표시의 위치를 업데이트하려면 다음 단계를 수행합니다.

1. 또는 이벤트에 대한 Control.DragOver 처리기에서 속성을 사용하여 ListView.InsertionMark 컨트롤과 연결된 개체에 ListViewInsertionMark 액세스합니다ListView.Control.MouseMove

2. 이 메서드를 NearestIndex 사용하여 마우스 포인터에 가장 가까운 항목의 인덱스 검색

3. 인덱스 값을 메서드에 ListView.GetItemRect 전달하여 항목의 경계 사각형을 검색합니다.

4. 마우스 포인터가 경계 사각형의 중간점 왼쪽에 있는 경우 속성을 /&S로 설정하고, 그렇지 않으면 설정합니다 .

5. Index 메서드에서 NearestIndex 검색된 인덱스 값으로 속성을 설정합니다. 삽입 표시는 속성 값에 따라 지정된 인덱스가 있는 항목 옆에 왼쪽 또는 오른쪽에 AppearsAfterItem 나타납니다. 항목 자체를 끌어온 경우 인덱스가 -1 삽입 표시가 숨겨집니다.

끌기된 항목을 올바른 위치에 삽입하려면 다음 단계를 수행합니다.

1. 또는 Control.MouseUp 이벤트에 대한 Control.DragDrop 처리기에서 속성을 사용하여 Index 삽입 표시의 현재 위치를 확인합니다. 나중에 삽입 인덱스로 사용할 이 값을 저장합니다.

2. 속성이 AppearsAfterItem 설정된 true경우 저장된 삽입 인덱스 값을 증분합니다.

3. 이 메서드를 ListView.ListViewItemCollection.Insert 사용하여 저장된 삽입 인덱스의 컬렉션에 ListView.Items 끌어온 항목의 복제본을 삽입합니다.

4. 이 메서드를 ListView.ListViewItemCollection.Remove 사용하여 끌기된 항목의 원래 복사본을 제거합니다.

원본 복사본이 제거되기 전에 끌어온 항목의 복제본을 삽입해야 컬렉션의 인덱스 값 ListView.Items 이 삽입되기 전에 변경되지 않습니다.

항목이 인덱스 값과 동일한 순서로 표시되도록 하려면 인덱스 값별로 항목을 정렬하는 인터페이스의 IComparer 구현으로 속성을 설정 ListView.ListViewItemSorter 해야 합니다. 자세한 내용은 예제 섹션을 참조하세요.

속성을 사용하여 삽입 표시의 색을 수정할 Color 수 있습니다. 삽입 표시의 크기 또는 위치가 필요한 경우 속성을 통해 Bounds 경계 사각형을 가져올 수 있습니다.

메모

삽입 표시 기능은 애플리케이션이 메서드를 호출 Application.EnableVisualStyles 할 때 Windows XP 및 Windows Server 2003 제품군에서만 사용할 수 있습니다. 이전 운영 체제에서는 삽입 표시와 관련된 모든 코드가 무시되고 삽입 표시가 표시되지 않습니다. 따라서 삽입 표시 기능에 의존하는 코드가 제대로 작동하지 않을 수 있습니다. 삽입 표시 기능을 사용할 수 있는지 여부를 결정하는 테스트를 포함하고 사용할 수 없는 경우 대체 기능을 제공할 수 있습니다. 예를 들어 삽입 표시를 지원하지 않는 운영 체제에서 실행할 때 끌어서 놓기 항목 위치를 구현하는 모든 코드를 바이패스할 수 있습니다.

삽입 표시 기능은 운영 체제 테마 기능을 제공하는 동일한 라이브러리에서 제공됩니다. 이 라이브러리의 가용성을 확인하려면 메서드 오버로드를 FeatureSupport.IsPresent(Object) 호출하고 값을 전달 OSFeature.Themes 합니다.

속성

Name	Description
AppearsAfterItem	속성에서 지정 Index 한 인덱스가 있는 항목의 오른쪽에 삽입 표시가 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.
Bounds	삽입 표시의 경계 사각형을 가져옵니다.
Color	삽입 표시의 색을 가져오거나 설정합니다.
Index	삽입 표시가 나타나는 옆에 있는 항목의 인덱스를 가져오거나 설정합니다.

메서드

Name	Description
NearestIndex(Point)	지정된 지점에 가장 가까운 항목의 인덱스를 검색합니다.

추가 정보

• ListView