ListBox.HorizontalExtent Właściwość

Definicja

Pobiera lub ustawia szerokość, za pomocą której można przewijać poziomy pasek przewijania ListBox.Gets or sets the width by which the horizontal scroll bar of a ListBox can scroll.

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

Wartość właściwości

Szerokość w pikselach, którą poziomy pasek przewijania może przewijać kontrolkę.The width, in pixels, that the horizontal scroll bar can scroll the control. Wartością domyślną jest zero.The default is zero.

Przykłady

Poniższy przykład kodu ilustruje sposób używania właściwości HorizontalScrollbar i HorizontalExtent do wyświetlania poziomego paska przewijania, który pokazuje cały tekst elementu w kontrolce ListBox.The following code example demonstrates how to use the HorizontalScrollbar and HorizontalExtent properties to display a horizontal scroll bar that shows all item text in the ListBox control. W przykładzie zastosowano również właściwość IntegralHeight, aby upewnić się, że elementy nie są częściowo wyświetlane ze względu na rozmiar kontrolki ListBox.The example also uses the IntegralHeight property to ensure that items are not partially displayed due to the size of the ListBox control. Ten przykład wymaga, aby kontrolka ListBox o nazwie listBox1została dodana do formularza.This example requires that a ListBox control, named listBox1, has been added to a form.

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

Uwagi

Ta właściwość służy tylko do raportowania przydatnej wartości, jeśli właściwość HorizontalScrollbar jest ustawiona na true.This property only reports a useful value if the HorizontalScrollbar property is set to true. Jeśli szerokość ListBox jest mniejsza niż wartość tej właściwości, poziomy pasek przewijania w poziomie przewinie elementy w ListBox.If the width of the ListBox is smaller than the value of this property, the horizontal scroll bar horizontally scrolls items in the ListBox. Jeśli szerokość ListBox jest równa lub większa niż ta wartość, poziomy pasek przewijania jest ukryty.If the width of the ListBox is equal to or greater than this value, the horizontal scroll bar is hidden. Wartość tej właściwości nie jest aktualizowana dynamicznie przez ListBox.The value of this property is not dynamically updated by the ListBox. Ta właściwość jest przydatna, gdy elementy ListBox są rysowane przez właściciela.This property is useful when the items of the ListBox are owner-drawn. Na przykład, jeśli elementy ListBox przez właściciela są 200 pikseli szerokości, ale ListBox ma 60 pikseli szerokości, właściwość HorizontalExtent musi być ustawiona na 200, aby przewijać prawą krawędź elementów do widocznego regionu formantu.For example, if the owner drawn items of the ListBox are 200 pixels wide, but the ListBox is 60 pixels wide, the HorizontalExtent property would need to be set to 200 in order to scroll the right edge of the items into the visible region of the control.

Dotyczy

Zobacz też