ListView.GetItemAt(Int32, Int32) Yöntem

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Öğeyi belirtilen konumda alır.

public:
 System::Windows::Forms::ListViewItem ^ GetItemAt(int x, int y);

public System.Windows.Forms.ListViewItem GetItemAt (int x, int y);

public System.Windows.Forms.ListViewItem? GetItemAt (int x, int y);

member this.GetItemAt : int * int -> System.Windows.Forms.ListViewItem

Public Function GetItemAt (x As Integer, y As Integer) As ListViewItem

Parametreler

x: Int32

Bir öğeyi aramak için konumun x koordinatı (istemci koordinatlarıyla ifade edilir).

y: Int32

Bir öğeyi aramak için konumun y koordinatı (istemci koordinatlarıyla ifade edilir).

Döndürülenler

ListViewItem

ListViewItem Belirtilen konumdaki öğeyi temsil eden bir. Belirtilen konumda öğe yoksa yöntemi döndürür null.

Örnekler

Aşağıdaki kod örneği ve ListView denetimlerinin PictureBox kullanımını gösterir. PictureBox, sırasıyla ve sabit listeleri kullanılarak BorderStyle ve PictureBox.SizeMode PictureBoxSizeMode özellikleri ayarlanarak PictureBox.BorderStyle başlatılır. ListView, Samples dizinindeki resimlerle doldurulur. yöntemi GetItemAt , bir öğenin seçilip seçilmediğini belirlemek için denetimin ListView MouseDown olayını işlerken kullanılır. Bir öğe seçilirse, olay işleyicisi özelliğini ayarlayarak PictureBox.Image seçili dosyayı görüntüler. Örnek için C:\documents ve Settings\All Users\Documents\My Pictures\Sample Pictures dizininde bulunan JPG dosyalarının bulunması gerekir. Bu örneği çalıştırmak için kodu bir forma yapıştırın ve formun InitializePictureBox oluşturucusunda veya Load yönteminde ve PopulateListView yöntemlerini çağırın. Tüm olayların olay işleyicileriyle ilişkilendirildiğinden emin olun.

private:
   void PopulateListView()
   {
      ListView1->Width = 270;
      ListView1->Location = System::Drawing::Point( 10, 10 );
      
      // Declare and construct the ColumnHeader objects.
      ColumnHeader^ header1;
      ColumnHeader^ header2;
      header1 = gcnew ColumnHeader;
      header2 = gcnew ColumnHeader;
      
      // Set the text, alignment and width for each column header.
      header1->Text = "File name";
      header1->TextAlign = HorizontalAlignment::Left;
      header1->Width = 70;
      header2->TextAlign = HorizontalAlignment::Left;
      header2->Text = "Location";
      header2->Width = 200;
      
      // Add the headers to the ListView control.
      ListView1->Columns->Add( header1 );
      ListView1->Columns->Add( header2 );
            
      // Specify that each item appears on a separate line.
      ListView1->View = View::Details;

      // Populate the ListView.Items property.
      // Set the directory to the sample picture directory.
      System::IO::DirectoryInfo^ dirInfo = gcnew System::IO::DirectoryInfo( "C:\\Documents and Settings\\All Users"
      "\\Documents\\My Pictures\\Sample Pictures" );
      
      // Get the .jpg files from the directory
      array<System::IO::FileInfo^>^files = dirInfo->GetFiles( "*.jpg" );
      
      // Add each file name and full name including path
      // to the ListView.
      if ( files != nullptr )
      {
         System::Collections::IEnumerator^ myEnum = files->GetEnumerator();
         while ( myEnum->MoveNext() )
         {
            System::IO::FileInfo^ file = safe_cast<System::IO::FileInfo^>(myEnum->Current);
            ListViewItem^ item = gcnew ListViewItem( file->Name );
            item->SubItems->Add( file->FullName );
            ListView1->Items->Add( item );
         }
      }
   }

   void InitializePictureBox()
   {
      PictureBox1 = gcnew PictureBox;
      
      // Set the location and size of the PictureBox control.
      this->PictureBox1->Location = System::Drawing::Point( 70, 120 );
      this->PictureBox1->Size = System::Drawing::Size( 140, 140 );
      this->PictureBox1->TabStop = false;
      
      // Set the SizeMode property to the StretchImage value.  This
      // will shrink or enlarge the image as needed to fit into
      // the PictureBox.
      this->PictureBox1->SizeMode = PictureBoxSizeMode::StretchImage;
      
      // Set the border style to a three-dimensional border.
      this->PictureBox1->BorderStyle = BorderStyle::Fixed3D;
      
      // Add the PictureBox to the form.
      this->Controls->Add( this->PictureBox1 );
   }

   void ListView1_MouseDown( Object^ /*sender*/, MouseEventArgs^ e )
   {
      ListViewItem^ selection = ListView1->GetItemAt( e->X, e->Y );
      
      // If the user selects an item in the ListView, display
      // the image in the PictureBox.
      if ( selection != nullptr )
      {
         PictureBox1->Image = System::Drawing::Image::FromFile( selection->SubItems[ 1 ]->Text );
      }
   }

private void PopulateListView()
{
    ListView1.Width = 270;
    ListView1.Location = new System.Drawing.Point(10, 10);

    // Declare and construct the ColumnHeader objects.
    ColumnHeader header1, header2;
    header1 = new ColumnHeader();
    header2 = new ColumnHeader();

    // Set the text, alignment and width for each column header.
    header1.Text = "File name";
    header1.TextAlign = HorizontalAlignment.Left;
    header1.Width = 70;

    header2.TextAlign = HorizontalAlignment.Left;
    header2.Text = "Location";
    header2.Width = 200;

    // Add the headers to the ListView control.
    ListView1.Columns.Add(header1);
    ListView1.Columns.Add(header2);

    // Specify that each item appears on a separate line.
    ListView1.View = View.Details;
    
    // Populate the ListView.Items property.
    // Set the directory to the sample picture directory.
    System.IO.DirectoryInfo dirInfo = 
        new System.IO.DirectoryInfo(
        "C:\\Documents and Settings\\All Users" +
        "\\Documents\\My Pictures\\Sample Pictures");

    // Get the .jpg files from the directory
    System.IO.FileInfo[] files = dirInfo.GetFiles("*.jpg");

    // Add each file name and full name including path
    // to the ListView.
    if (files != null)
    {
        foreach ( System.IO.FileInfo file in files )
        {
            ListViewItem item = new ListViewItem(file.Name);
            item.SubItems.Add(file.FullName);
            ListView1.Items.Add(item);
        }
    }
}

private void InitializePictureBox()
{
    PictureBox1 = new PictureBox();

    // Set the location and size of the PictureBox control.
    this.PictureBox1.Location = new System.Drawing.Point(70, 120);
    this.PictureBox1.Size = new System.Drawing.Size(140, 140);
    this.PictureBox1.TabStop = false;

    // Set the SizeMode property to the StretchImage value.  This
    // will shrink or enlarge the image as needed to fit into
    // the PictureBox.
    this.PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage;

    // Set the border style to a three-dimensional border.
    this.PictureBox1.BorderStyle = BorderStyle.Fixed3D;

    // Add the PictureBox to the form.
    this.Controls.Add(this.PictureBox1);
}

private void ListView1_MouseDown(object sender, MouseEventArgs e)
{

    ListViewItem selection = ListView1.GetItemAt(e.X, e.Y);

    // If the user selects an item in the ListView, display
    // the image in the PictureBox.
    if (selection != null)
    {
        PictureBox1.Image = System.Drawing.Image.FromFile(
            selection.SubItems[1].Text);
    }
}

Private Sub PopulateListView()
    ListView1.Width = 270
    ListView1.Location = New System.Drawing.Point(10, 10)

    ' Declare and construct the ColumnHeader objects.
    Dim header1, header2 As ColumnHeader
    header1 = New ColumnHeader
    header2 = New ColumnHeader

    ' Set the text, alignment and width for each column header.
    header1.Text = "File name"
    header1.TextAlign = HorizontalAlignment.Left
    header1.Width = 70

    header2.TextAlign = HorizontalAlignment.Left
    header2.Text = "Location"
    header2.Width = 200

    ' Add the headers to the ListView control.
    ListView1.Columns.Add(header1)
    ListView1.Columns.Add(header2)

    ' Specify that each item appears on a separate line.
    ListView1.View = View.Details

    ' Populate the ListView.Items property.
    ' Set the directory to the sample picture directory.
    Dim dirInfo As New System.IO.DirectoryInfo _
        ("C:\Documents and Settings\All Users" _
        & "\Documents\My Pictures\Sample Pictures")
    Dim file As System.IO.FileInfo

    ' Get the .jpg files from the directory
    Dim files() As System.io.FileInfo = dirInfo.GetFiles("*.jpg")

    ' Add each file name and full name including path
    ' to the ListView.
    If (files IsNot Nothing) Then
        For Each file In files
            Dim item As New ListViewItem(file.Name)
            item.SubItems.Add(file.FullName)
            ListView1.Items.Add(item)
        Next
    End If
End Sub

Private Sub InitializePictureBox()
    PictureBox1 = New PictureBox

    ' Set the location and size of the PictureBox control.
    Me.PictureBox1.Location = New System.Drawing.Point(70, 120)
    Me.PictureBox1.Size = New System.Drawing.Size(140, 140)
    Me.PictureBox1.TabStop = False

    ' Set the SizeMode property to the StretchImage value.  This
    ' will shrink or enlarge the image as needed to fit into
    ' the PictureBox.
    Me.PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage

    ' Set the border style to a three-dimensional border.
    Me.PictureBox1.BorderStyle = BorderStyle.Fixed3D

    ' Add the PictureBox to the form.
    Me.Controls.Add(Me.PictureBox1)

End Sub


Private Sub ListView1_MouseDown(ByVal sender As Object, _
    ByVal e As MouseEventArgs) Handles ListView1.MouseDown

    Dim selection As ListViewItem = ListView1.GetItemAt(e.X, e.Y)

    ' If the user selects an item in the ListView, display
    ' the image in the PictureBox.
    If (selection IsNot Nothing) Then
        PictureBox1.Image = System.Drawing.Image.FromFile _
            (selection.SubItems(1).Text)
    End If


End Sub

Açıklamalar

yöntemi, GetItemAt denetimin istemci bölgesi içinde belirli bir konumda hangi öğenin bulunduğunu belirlemenize ListView olanak tanır. Kullanıcı bir alt öğeye tıkladığında veya sağ tıkladığında (özellik olarak ayarlandığındaView.Details) ve kullanıcının fareyi tıklattığı View sırada fare koordinatlarına göre tıklanan alt öğeye sahip olan öğeyi belirlemek istediğinizde bu yöntemi kullanabilirsiniz.

Not

FullRowSelect Özellik değeri olduğundafalse, bu yöntem yalnızca belirtilen konum üst öğenin sınırları içinde olduğunda (denetim ayrıntı modundayken ilk sütunda görüntülenir) bir öğe döndürür. Bir alt öğenin sınırları içinde bir konum verilen bu yönteme sahip bir öğeyi almak için true özelliğini olarak ayarlamanız FullRowSelect gerekir. Belirli bir konumdaki HitTest öğe hakkında ayrıntılı bilgileri almak için yöntemini de kullanabilirsiniz.

içindeki ListViewöğelerin sürükle ve bırak yeniden konumlandırmasını yapmak için yöntemi yerine GetItemAt yöntemini kullanmak ListViewInsertionMark.NearestIndex isteyebilirsiniz. yöntemi, ListViewInsertionMark.NearestIndex fare işaretçisinin bulunduğu konumdan bağımsız olarak en yakın öğeyi bulur. GetItemAt Diğer yandan yöntemi, belirtilen konumda öğe yoksa döndürürnull.

Not

ListViewInsertionMark sınıfı yalnızca uygulamanız yöntemini çağırdığında Windows XP ve Windows Server 2003'te Application.EnableVisualStyles desteklenir.

Şunlara uygulanır