ListBox.HorizontalScrollbar-Eigenschaft

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)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Property HorizontalScrollbar As Boolean
'Usage
Dim instance As ListBox
Dim value As Boolean

value = instance.HorizontalScrollbar

instance.HorizontalScrollbar = value

[LocalizableAttribute(true)] 
public bool HorizontalScrollbar { get; set; }

[LocalizableAttribute(true)] 
public:
property bool HorizontalScrollbar {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_HorizontalScrollbar ()

/** @property */
public void set_HorizontalScrollbar (boolean value)

public function get HorizontalScrollbar () : boolean

public function set HorizontalScrollbar (value : boolean)

Eigenschaftenwert

true, um eine horizontale Bildlaufleiste im Steuerelement anzuzeigen, andernfalls false. Der Standardwert ist false.

Hinweise

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.

Beispiel

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 Sub DisplayHScroll()
   ' Make no partial items are displayed vertically.
   listBox1.IntegralHeight = True
   Dim x As Integer

   ' Add items that are wide to the ListBox.
   For x = 0 To 10
      listBox1.Items.Add("Item  " + x.ToString() + " is a very large value that requires scroll bars")
   Next x

   ' 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.
   Dim g As System.Drawing.Graphics = listBox1.CreateGraphics()


   ' Determine the size for HorizontalExtent using the MeasureString method using the last item in the list.
   Dim hzSize As Integer = g.MeasureString(listBox1.Items(listBox1.Items.Count - 1).ToString(), listBox1.Font).Width
   ' Set the HorizontalExtent property.
   listBox1.HorizontalExtent = hzSize
End Sub

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->IntegralHeight = true;

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

      }

      // 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( dynamic_cast<String^>(listBox1->Items[ listBox1->Items->Count - 1 ]), 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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ListBox-Klasse
ListBox-Member
System.Windows.Forms-Namespace
ListBox.HorizontalExtent-Eigenschaft