ListBox.IntegralHeight Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

ListBox.cs

Возвращает или задает значение, указывающее, должен ли элемент управления изменять размер, чтобы избежать отображения частичных элементов.

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

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

Boolean

true Значение , если элемент управления изменяет размер, чтобы он не отображал частичные элементы; falseв противном случае . Значение по умолчанию — true.

Примеры

В следующем примере кода показано, как использовать HorizontalScrollbar и HorizontalExtent свойства для отображения горизонтальной полосы прокрутки, отображающей весь текст элемента в элементе ListBox управления. В примере также используется IntegralHeight свойство, чтобы убедиться, что элементы не отображаются частично из-за размера ListBox элемента управления. В этом примере требуется, чтобы ListBox элемент управления с именем listBox1был добавлен в форму.

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значение, элемент управления автоматически изменяет размер, чтобы убедиться, что элемент не отображается частично. Если вы хотите сохранить исходный размер на основе требований ListBox к пространству формы, задайте для этого свойства значение false.

По умолчанию размеры ListBox отображаются CheckedListBox только целыми элементами. Если вы хотите ListBox или полностью заполнить закрепленную область, установите для нее значение falseIntegralHeightCheckedListBox . Это приводит к полному заполнению области, но последний элемент не отображается полностью.

Если элемент ListBox не содержит элементов, это свойство не действует.

Замечание

Целочисленная высота зависит от высоты ListBox, а не высоты клиентской области. В результате при IntegralHeight установке trueсвойства элементы по-прежнему могут быть частично показаны, если отображаются полосы прокрутки.

Замечание

DrawMode Если для свойства задано DrawMode.OwnerDrawVariableзначение, это свойство не действует.

См. также раздел

• DrawMode