ListBox.HorizontalExtent Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Breite ab, innerhalb der mit einer horizontalen Schiebeleiste einer ListBox Bildläufe durchgeführt werden können, oder legt diese fest.
public:
property int HorizontalExtent { int get(); void set(int value); };
public int HorizontalExtent { get; set; }
member this.HorizontalExtent : int with get, set
Public Property HorizontalExtent As Integer
Eigenschaftswert
Die Breite in Pixel, innerhalb der mit der horizontalen Schiebeleiste im Steuerelement Bildläufe durchgeführt werden können. Der Standardwert ist 0.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der HorizontalScrollbar Eigenschaften HorizontalExtent eine horizontale Bildlaufleiste anzeigen, die den gesamten Elementtext im ListBox Steuerelement anzeigt. Im Beispiel wird auch die IntegralHeight Eigenschaft verwendet, um sicherzustellen, dass Elemente aufgrund der Größe des ListBox Steuerelements nicht teilweise angezeigt werden. In diesem Beispiel ist erforderlich, dass einem Formular ein ListBox Steuerelement mit dem Namen listBox1
hinzugefügt wurde.
private:
void DisplayHScroll()
{
// Make sure no items are displayed partially.
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 sure no items are displayed partially.
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 Sub DisplayHScroll()
' Make sure no items are displayed partially.
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
Hinweise
Diese Eigenschaft meldet nur einen nützlichen Wert, wenn die HorizontalScrollbar Eigenschaft auf true
. Wenn die Breite der ListBox Eigenschaft kleiner als der Wert dieser Eigenschaft ist, wird die horizontale Bildlaufleiste horizontal scrollt Elemente in der ListBox. Wenn die Breite des ListBox Werts gleich oder größer ist, wird die horizontale Bildlaufleiste ausgeblendet. Der Wert dieser Eigenschaft wird nicht dynamisch von der ListBox. Diese Eigenschaft ist nützlich, wenn die Elemente des ListBox Besitzers gezeichnet werden. Wenn beispielsweise der Besitzer gezeichnete Elemente der ListBox 200 Pixel breit ist, aber die ListBox 60 Pixel breit ist, muss die HorizontalExtent Eigenschaft auf 200 festgelegt werden, um den rechten Rand der Elemente in den sichtbaren Bereich des Steuerelements zu scrollen.