ListViewInsertionMark.Index プロパティとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ListViewInsertionMark.Index プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

挿入マークが表示される位置の横にある項目のインデックスを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property Index As
 Integer

Visual Basic (使用法)

Dim instance As ListViewInsertionMark
Dim value As Integer

value = instance.Index

instance.Index = value

public int Index { get;
 set; }

C++

public:
property int Index {
    int get ();
    void set (int value);
}

/** @property */
public int get_Index ()

/** @property */
public void set_Index (int
 value)

JScript

public function get Index
 () : int

public function set Index
 (value : int)

プロパティ値
挿入マークが表示される位置の横にある項目のインデックス。挿入マークが非表示の時には、-1 が返されます。

解説

AppearsAfterItem プロパティが false の場合、指定されたインデックスを持つ項目の左側に挿入マークが表示されます。それ以外の場合、項目の右側に挿入マークが表示されます。ドラッグしている項目が ListView.Items コレクションに挿入されると、挿入マークは自動的に消えます。たとえば項目をその項目自体の上にドラッグした場合や、コントロールの外にドラッグした場合に、挿入マークを手動で削除するには、Index 値を -1 に設定します。

ドラッグアンドドロップ操作で項目を移動するときに、マウスポインタの位置など、指定した位置に最も近い項目のインデックスを取得するには、NearestIndex メソッドを使用します。

使用例

ListView の挿入マーク機能を使用し、標準のドラッグイベントを使ったドラッグアンドドロップ項目の並べ替えを実装する方法を次のコード例に示します。挿入マークの位置は、Control.DragOver イベントのハンドラで更新されます。このハンドラでは、マウスポインタの位置を、最も近くにある項目の中心と比較し、その結果を使用して、挿入マークを項目の右に表示するか、左に表示するかを決定しています。

コード全体については、ListViewInsertionMark の概要のリファレンストピックを参照してください。

Visual Basic

' 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 'myListView_DragOver

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

C++

// 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.get_X(), e.get_Y()));
    // Retrieve the index of the item closest to the mouse pointer.
    int targetIndex = myListView.get_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.get_X() > itemBounds.get_Left() 
            + itemBounds.get_Width() / 2) {
            myListView.get_InsertionMark().set_AppearsAfterItem(true);
        }
        else {
            myListView.get_InsertionMark().set_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.get_InsertionMark().set_Index(targetIndex);
} //myListView_DragOver

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ListViewInsertionMark クラス
ListViewInsertionMark メンバ
System.Windows.Forms 名前空間
ListView クラス

このページでは「.NET Framework クラスライブラリリファレンス」からListViewInsertionMark.Index プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からListViewInsertionMark.Index プロパティを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からListViewInsertionMark.Index プロパティを検索

>> 「ListViewInsertionMark.Index プロパティ」を含む用語の索引
ListViewInsertionMark.Index プロパティのページへのリンク


	© 2025 Microsoft.All rights reserved.

ListViewInsertionMark.Index プロパティとは？ わかりやすく解説

ListViewInsertionMark.Index プロパティ

急上昇のことば

ListViewInsertionMark.Index プロパティとは？わかりやすく解説