ListViewItem.Position プロパティ

.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

C#

public Point Position { get; set;
 }

C++

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

J#

/** @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

C#

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

プラットフォーム

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

参照

関連項目
ListViewItem クラス
ListViewItem メンバ
System.Windows.Forms 名前空間
ListView クラス
ListView.View プロパティ
Point
その他の技術情報
Windows フォームの座標