ColumnHeader ColumnHeader ColumnHeader ColumnHeader Class

Definition

Zeigt einen einzelnen Spaltenkopf in einem ListView-Steuerelement an.Displays a single column header in a ListView control.

public ref class ColumnHeader : System::ComponentModel::Component, ICloneable
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ColumnHeaderConverter))]
public class ColumnHeader : System.ComponentModel.Component, ICloneable
type ColumnHeader = class
    inherit Component
    interface ICloneable
Public Class ColumnHeader
Inherits Component
Implements ICloneable
Vererbung
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel wird die Initialisierung ListView eines-Steuer Elements veranschaulicht.The following code example demonstrates initializing a ListView control. Im Beispiel werden ColumnHeader -Objekte erstellt und die-, Text TextAlign -und Width -Eigenschaften des Spalten Headers festgelegt.The example creates ColumnHeader objects and sets the column header's Text, TextAlign and Width properties. Im Beispiel werden auch Elemente und unter ListViewElemente hinzugefügt.The example also adds items and subitems to the ListView. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Formular ein, PopulateListView und nennen Sie die-Methode aus dem Load Konstruktor oder Ereignishandler des Formulars.To run this example paste the following code in a form and call the PopulateListView method from the form's constructor or Load event handler.

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

Hinweise

Eine Spaltenüberschrift ist ein Element in ListView einem Steuerelement, das Überschrift Text enthält.A column header is an item in a ListView control that contains heading text. ColumnHeader-Objekte können einem ListView mithilfe der Add -Methode der ListView.ColumnHeaderCollection -Klasse hinzugefügt werden.ColumnHeader objects can be added to a ListView using the Add method of the ListView.ColumnHeaderCollection class. Wenn Sie einer eine Gruppe von Spalten ListViewhinzufügen möchten, können Sie die AddRange -Methode ListView.ColumnHeaderCollection der-Klasse verwenden.To add a group of columns to a ListView, you can use the AddRange method of the ListView.ColumnHeaderCollection class. Sie können die Index -Eigenschaft ColumnHeader der-Klasse verwenden, um zu ColumnHeader bestimmen, wo sich ListView.ColumnHeaderCollectiondas in der befindet.You can use the Index property of the ColumnHeader class to determine where the ColumnHeader is located in the ListView.ColumnHeaderCollection.

ColumnHeaderstellt die Text - TextAlign Eigenschaft und die-Eigenschaft bereit, um den im-Steuerelement angezeigten Text und die Ausrichtung des Texts im Spaltenheader festzulegen.ColumnHeader provides the Text and TextAlign properties to set the text displayed in the control and the alignment of the text in the column header. Um zu ermitteln, ColumnHeader ob ein einem- ListView Steuerelement zugeordnet ist, können ListView Sie auf die-Eigenschaft verweisen.To determine whether a ColumnHeader is associated with a ListView control, you can reference the ListView property. Wenn Sie ein ColumnHeader -Element für die Verwendung in einem ListView anderen Steuerelement kopieren möchten, Clone können Sie die-Methode verwenden.If you want to copy a ColumnHeader for use in another ListView control, you can use the Clone method.

Konstruktoren

ColumnHeader() ColumnHeader() ColumnHeader() ColumnHeader()

Initialisiert eine neue Instanz der ColumnHeader-Klasse.Initializes a new instance of the ColumnHeader class.

ColumnHeader(Int32) ColumnHeader(Int32) ColumnHeader(Int32) ColumnHeader(Int32)

Initialisiert eine neue Instanz der ColumnHeader-Klasse mit dem angegebenen Bild.Initializes a new instance of the ColumnHeader class with the image specified.

ColumnHeader(String) ColumnHeader(String) ColumnHeader(String) ColumnHeader(String)

Initialisiert eine neue Instanz der ColumnHeader-Klasse mit dem angegebenen Bild.Initializes a new instance of the ColumnHeader class with the image specified.

Eigenschaften

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
DisplayIndex DisplayIndex DisplayIndex DisplayIndex

Ruft die Anzeigereihenfolge der Spalte relativ zu den derzeit angezeigten Spalten ab oder legt sie fest.Gets or sets the display order of the column relative to the currently displayed columns.

Events Events Events Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
ImageIndex ImageIndex ImageIndex ImageIndex

Ruft den Index des im ColumnHeader angezeigten Bilds ab oder legt diesen fest.Gets or sets the index of the image displayed in the ColumnHeader.

ImageKey ImageKey ImageKey ImageKey

Ruft den Schlüssel des in der Spalte angezeigten Bilds ab oder legt diesen fest.Gets or sets the key of the image displayed in the column.

ImageList ImageList ImageList ImageList

Ruft die dem ColumnHeader zugeordnete Bildliste ab.Gets the image list associated with the ColumnHeader.

Index Index Index Index

Ruft die Position mit der ListView dieses ListView.ColumnHeaderCollection-Steuerelements für diese Spalte ab.Gets the location with the ListView control's ListView.ColumnHeaderCollection of this column.

ListView ListView ListView ListView

Ruft das ListView-Steuerelement ab, in dem sich ColumnHeader befindet.Gets the ListView control the ColumnHeader is located in.

Name Name Name Name

Ruft den Namen der ColumnHeader ab oder legt diesen fest.Gets or sets the name of the ColumnHeader.

Site Site Site Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Inherited from Component)
Tag Tag Tag Tag

Ruft das Objekt ab, das dem ColumnHeader zuzuordnende Daten enthält, oder legt dieses fest.Gets or sets an object that contains data to associate with the ColumnHeader.

Text Text Text Text

Ruft den im Spaltenkopf angezeigten Text ab oder legt diesen fest.Gets or sets the text displayed in the column header.

TextAlign TextAlign TextAlign TextAlign

Ruft die horizontale Ausrichtung des in ColumnHeader angezeigten Texts ab oder legt diese fest.Gets or sets the horizontal alignment of the text displayed in the ColumnHeader.

Width Width Width Width

Ruft die Breite der Spalte ab oder legt diese fest.Gets or sets the width of the column.

Methoden

AutoResize(ColumnHeaderAutoResizeStyle) AutoResize(ColumnHeaderAutoResizeStyle) AutoResize(ColumnHeaderAutoResizeStyle) AutoResize(ColumnHeaderAutoResizeStyle)

Ändert die Breite der Spalte gemäß der Formatvorlage für die Größenänderung.Resizes the width of the column as indicated by the resize style.

Clone() Clone() Clone() Clone()

Erstellt eine identische Kopie des aktuellen ColumnHeader, die an kein Listenansicht-Steuerelement angefügt ist.Creates an identical copy of the current ColumnHeader that is not attached to any list view control.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von der ColumnHeader-Klasse verwendeten Ressourcen (mit Ausnahme des Speichers) frei.Disposes of the resources (other than memory) used by the ColumnHeader.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden).Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

Ereignisse

Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Gilt für:

Siehe auch