Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

ListBox.HorizontalScrollbar-Eigenschaft

Aktualisiert: November 2007

Ruft einen Wert ab, der angibt, ob im Steuerelement eine horizontale Bildlaufleiste angezeigt wird, oder legt diesen fest.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public bool HorizontalScrollbar { get; set; }
/** @property */
public boolean get_HorizontalScrollbar()
/** @property */
public  void set_HorizontalScrollbar(boolean value)

public function get HorizontalScrollbar () : boolean
public function set HorizontalScrollbar (value : boolean)

Eigenschaftenwert

Typ: System.Boolean
true, um eine horizontale Bildlaufleiste im Steuerelement anzuzeigen, andernfalls false. Der Standardwert ist false.

Die HorizontalScrollbar-Eigenschaft bestimmt, ob in ListBox eine horizontale Bildlaufleiste angezeigt werden soll, wenn die Breite der Elemente in der ListBox den rechten Rand des Steuerelements überschreitet. Wenn diese Eigenschaft auf true festgelegt ist, wird die Bildlaufleiste automatisch entsprechend der Breite der Elemente in der ListBox angezeigt. Wenn die ListBox ein Ownerdrawn-ListBox ist, müssen Sie die HorizontalExtent-Eigenschaft festlegen, um eine horizontale Bildlaufleiste richtig anzuzeigen.

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der HorizontalScrollbar-Eigenschaft und der HorizontalExtent-Eigenschaft eine horizontale Bildlaufleiste angezeigt wird, mit der der gesamte Elementtext im ListBox-Steuerelement angezeigt werden kann. In diesem Beispiel wird mithilfe der IntegralHeight-Eigenschaft sichergestellt, dass Elemente aufgrund der Größe des ListBox-Steuerelements nicht abgeschnitten werden. Für dieses Beispiel muss dem Formular das ListBox-Steuerelement listBox1 hinzugefügt werden.

private void DisplayHScroll()
{
   // Make no partial items are displayed vertically.
   listBox1.IntegralHeight = true;

   // Add items that are wide to the ListBox.
   for (int x = 0; x < 10; x++)
   {
      listBox1.Items.Add("Item  " + x.ToString() + " is a very large value that requires scroll bars");
   }

   // Display a horizontal scroll bar.
   listBox1.HorizontalScrollbar = true;

   // Create a Graphics object to use when determining the size of the largest item in the ListBox.
   Graphics g = listBox1.CreateGraphics();

   // Determine the size for HorizontalExtent using the MeasureString method using the last item in the list.
   int hzSize = (int) g.MeasureString(listBox1.Items[listBox1.Items.Count -1].ToString(),listBox1.Font).Width;
   // Set the HorizontalExtent property.
   listBox1.HorizontalExtent = hzSize;
}


private void DisplayHScroll()
{
    // Make no partial items are displayed vertically.
    listBox1.set_IntegralHeight(true);

    // Add items that are wide to the ListBox.
    for (int x = 0; x < 10; x++) {
        listBox1.get_Items().Add("Item  " + Convert.ToString(x) 
            + " is a very large value that requires scroll bars");
    }

    // Display a horizontal scroll bar.
    listBox1.set_HorizontalScrollbar(true);

    // Create a Graphics object to use when determining the size 
    // of the largest item in the ListBox.
    Graphics g = listBox1.CreateGraphics();

    // Determine the size for HorizontalExtent using the MeasureString 
    // method using the last item in the list.
    int hzSize = (int)(g.MeasureString(listBox1.get_Items().
        get_Item(listBox1.get_Items().get_Count() - 1).ToString(), 
        listBox1.get_Font()).get_Width());

    // Set the HorizontalExtent property.
    listBox1.set_HorizontalExtent(hzSize);
} //DisplayHScroll


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0, 1.1, 1.0
Anzeigen: