ListBox.IntegralHeight ListBox.IntegralHeight ListBox.IntegralHeight ListBox.IntegralHeight Property

Определение

Возвращает или задает значение, указывающее, должны ли изменяться размеры элемента управления, чтобы избежать частичного отображения элементов.Gets or sets a value indicating whether the control should resize to avoid showing partial items.

public:
 property bool IntegralHeight { bool get(); void set(bool value); };
public bool IntegralHeight { get; set; }
member this.IntegralHeight : bool with get, set
Public Property IntegralHeight As Boolean

Значение свойства

true, если элемент управления изменяет свои размеры, чтобы избежать частичного отображения позиций; в противном случае false.true if the control resizes so that it does not display partial items; otherwise, false. Значение по умолчанию — true.The default is true.

Примеры

В следующем примере кода демонстрируется использование HorizontalScrollbar и HorizontalExtent свойства для отображения горизонтальной полосы прокрутки, показывающий весь текст элемента в 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. В примере также используется IntegralHeight свойство, чтобы убедиться, что элементы не отображаются частично из-за размера ListBox элемента управления.The example also uses the IntegralHeight property to ensure that items are not partially displayed due to the size of the ListBox control. В этом примере требуется, ListBox управления с именем listBox1, был добавлен в форму.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

Комментарии

Если присвоить этому свойству true, чтобы убедиться, что элемент не отображается частично автоматически размера элемента управления.When this property is set to true, the control automatically resizes to ensure that an item is not partially displayed. Если вы хотите поддерживать исходного размера ListBox исходя из требований к месту на форму, присвойте этому свойству значение false.If you want to maintain the original size of the ListBox based on the space requirements of your form, set this property to false.

По умолчанию ListBox и CheckedListBox размеры таковы, что они показывают только целые элементы.By default, the ListBox and the CheckedListBox sizes are such that they show only whole items. Если вы хотите, чтобы ListBox или CheckedListBox Чтобы полностью заполнить область закрепленной, задайте IntegralHeight для false.If you want the ListBox or CheckedListBox to completely fill a docked area, set IntegralHeight to false. В результате элемент управления, чтобы полностью заполнить область, но последний элемент не отображается полностью.This causes the control to completely fill the area, but the last item is not fully displayed.

Если ListBox не содержит элементов, это свойство не влияет.If the ListBox does not contain any items, this property has no effect.

Примечание

Общая высота основан на высоту ListBox, вместо того чтобы высота клиентской области.The integral height is based on the height of the ListBox, rather than the client area height. В результате, когда IntegralHeight свойству true, могут по-прежнему частично отображаться элементы, если отображаются полосы прокрутки.As a result, when the IntegralHeight property is set true, items can still be partially shown if scroll bars are displayed.

Примечание

Если DrawMode свойству DrawMode.OwnerDrawVariable, это свойство не влияет.If the DrawMode property is set to DrawMode.OwnerDrawVariable, this property has no effect.

Применяется к

Дополнительно