ListViewItem.GetSubItemAt メソッド

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

ListViewItem.GetSubItemAt メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ListViewItem の指定した座標にあるサブ項目を返します。

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

Visual Basic (宣言)

Public Function GetSubItemAt ( _
    x As Integer, _
    y As Integer _
) As ListViewSubItem

Visual Basic (使用法)

Dim instance As ListViewItem
Dim x As Integer
Dim y As Integer
Dim returnValue As ListViewSubItem

returnValue = instance.GetSubItemAt(x, y)

C#

public ListViewSubItem GetSubItemAt (
    int x,
    int y
)

C++

public:
ListViewSubItem^ GetSubItemAt (
    int x, 
    int y
)

J#

public ListViewSubItem GetSubItemAt (
    int x, 
    int y
)

JScript

public function GetSubItemAt (
    x : int, 
    y : int
) : ListViewSubItem

パラメータ

x

x 座標。

y

y 座標。

戻り値
指定した x 座標および y 座標にある ListViewItem.ListViewSubItem。

解説

GetSubItemAt メソッドは、ListView が Details ビューでない場合、または指定した位置に ListViewItem.ListViewSubItem が存在しない場合には、null 参照 (Visual Basic では Nothing) を返します。

使用例

GetSubItemAt メソッドを使用する方法を次のコード例に示します。このコードを実行するには、コードを Windows フォームに貼り付け、フォームのコンストラクタまたは Load のイベント処理メソッドから InitializeListView1 を呼び出します。

Visual Basic

Private WithEvents listView1 As
 ListView

Private Sub InitializeListView1()
    listView1 = New ListView()

    ' Set the view to details to show subitems.
    listView1.View = View.Details

    ' Add some columns and set the width.
    listView1.Columns.Add("Name")
    listView1.Columns.Add("Number")
    listView1.Columns.Add("Description")
    listView1.Width = 175

    ' Create some items and subitems; add the to the ListView.
    Dim item1 As New ListViewItem("Widget")
    item1.SubItems.Add(New ListViewItem.ListViewSubItem(item1,
 "14"))
    item1.SubItems.Add(New ListViewItem.ListViewSubItem(item1,
 "A description of Widget"))
    Dim item2 As New ListViewItem("Bracket")
    item2.SubItems.Add(New ListViewItem.ListViewSubItem(item2,
 "8"))
    listView1.Items.Add(item1)
    listView1.Items.Add(item2)

    ' Add the ListView to the form.
    Me.Controls.Add(listView1)
End Sub

Private Sub listView1_MouseDown(ByVal
 sender As Object, ByVal
 e As MouseEventArgs)


    ' Get the item at the mouse pointer.
    Dim info As ListViewHitTestInfo = listView1.HitTest(e.X,
 e.Y)

    Dim subItem As ListViewItem.ListViewSubItem
 = Nothing

    ' Get the subitem 120 pixels to the right.
    If Not (info Is Nothing)
 Then
        If Not (info.Item Is
 Nothing) Then
            subItem = info.Item.GetSubItemAt(e.X + 120, e.Y)
        End If
    End If ' Show the text of
 the subitem, if found.
    If Not (subItem Is Nothing)
 Then
        MessageBox.Show(subItem.Text)
    End If
End Sub

C#

private ListView listView1;

private void  InitializeListView1(){
    listView1 = new ListView();
    
    // Set the view to details to show subitems.
    listView1.View = View.Details;
   
    // Add some columns and set the width.
    listView1.Columns.Add("Name");
    listView1.Columns.Add("Number");
    listView1.Columns.Add("Description");
    listView1.Width = 175;

    // Create some items and subitems; add the to the ListView.
    ListViewItem item1 = new ListViewItem("Widget");
    item1.SubItems.Add(new ListViewItem.ListViewSubItem(item1,
 "14"));
    item1.SubItems.Add(new ListViewItem.ListViewSubItem(item1,
 
        "A description of Widget"));
    ListViewItem item2 = new ListViewItem("Bracket");
    item2.SubItems.Add(new ListViewItem.ListViewSubItem(item2,
 "8"));
    listView1.Items.Add(item1);
    listView1.Items.Add(item2);
    
    // Add the ListView to the form.
    this.Controls.Add(listView1);
    listView1.MouseDown += new MouseEventHandler(listView1_MouseDown);
}

void listView1_MouseDown(object sender, MouseEventArgs e)
{
    // Get the item at the mouse pointer.
    ListViewHitTestInfo info = listView1.HitTest(e.X, e.Y);

    ListViewItem.ListViewSubItem subItem = null;
    
    // Get the subitem 120 pixels to the right.
    if (info != null)
        if (info.Item != null)
            subItem = info.Item.GetSubItemAt(e.X + 120, e.Y);
    
    // Show the text of the subitem, if found.
    if (subItem != null)
        MessageBox.Show(subItem.Text);
}

プラットフォーム

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 名前空間