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

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

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

ListViewItem.Position プロパティ

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

ListViewItem の左上隅の位置を取得または設定します。

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

Visual Basic (宣言)

Public Property Position As
 Point

Visual Basic (使用法)

Dim instance As ListViewItem
Dim value As Point

value = instance.Position

instance.Position = value

public Point Position { get; set;
 }

C++

public:
property Point Position {
    Point get ();
    void set (Point value);
}

/** @property */
public Point get_Position ()

/** @property */
public void set_Position (Point value)

JScript

public function get Position
 () : Point

public function set Position
 (value : Point)

プロパティ値
ListViewItem の左上隅の Point。

例外

例外の種類	条件
InvalidOperationException	項目を格納する ListView が仮想モードのときに Position が設定されています。

解説

Position プロパティは、ListViewItem とそれを格納する ListView が作成された後に設定する必要があります。項目を格納する ListView が Details ビューまたは List ビューであるときに Position プロパティを変更しても、項目の位置に影響はありません。また、項目を格納する ListView の View プロパティが、SmallIcon、LargeIcon、または Tile の各ビューから、List ビューまたは Details ビューに変更されると、Position プロパティが自動的に変更されます。ListView が、SmallIcon、LargeIcon、または Tile の各ビューであるときは、項目の Position プロパティを設定すると、ListView に格納されている他の項目が再配置されます。

使用例

ListViewItem の Position プロパティを使用する方法を次のコード例に示します。この例を実行するには、次のコードを Windows フォームに貼り付け、フォームの Load のイベント処理メソッドから InitializePositionedListViewItems を呼び出します。ボタンをクリックして、項目が再配置されることを確認してください。

Visual Basic

Private positionListView As ListView
Private moveItem As ListViewItem
Private WithEvents button1 As
 Button


Private Sub InitializePositionedListViewItems()
 
    ' Set some basic properties on the ListView and button.
    positionListView = New ListView()
    positionListView.Height = 200
    button1 = New Button()
    button1.Location = New Point(160, 30)
    button1.AutoSize = True
    button1.Text = "Click to reposition"

    ' View must be set to icon view to use the Position property.
    positionListView.View = View.LargeIcon
    
    ' Create the items and add them to the ListView.
    Dim item1 As New ListViewItem("Click")
    Dim item2 As New ListViewItem("OK")
    moveItem = New ListViewItem("Move")
    positionListView.Items.AddRange(New ListViewItem() _
        {item1, item2, moveItem})
    
    ' Add the controls to the form.
    Me.Controls.Add(positionListView)
    Me.Controls.Add(button1)

End Sub

Private Sub button1_Click(ByVal
 sender As Object, ByVal
 e As EventArgs)
    moveItem.Position = New Point(30, 30)
End Sub

private ListView positionListView;
private ListViewItem moveItem;
private Button button1;

private void InitializePositionedListViewItems()
{
    // Set some basic properties on the ListView and button.
    positionListView = new ListView();
    positionListView.Height = 200;
    button1 = new Button();
    button1.Location = new Point(160, 30);
    button1.AutoSize = true;
    button1.Text = "Click to reposition";
    button1.Click += new System.EventHandler(button1_Click);

    // View must be set to icon view to use the Position property.
    positionListView.View = View.LargeIcon;
  
    // Create the items and add them to the ListView.
    ListViewItem item1 = new ListViewItem("Click");
    ListViewItem item2 = new ListViewItem("OK");
    moveItem = new ListViewItem("Move");
    positionListView.Items.AddRange(new ListViewItem[] 
        { item1, item2, moveItem });

    // Add the controls to the form.
    this.Controls.Add(positionListView);
    this.Controls.Add(button1);
}

private void button1_Click(object sender, EventArgs
 e)
{
    moveItem.Position = new Point(30, 30);
}