ListBox.IntegralHeight Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy formant powinien zmienić rozmiar, aby uniknąć wyświetlania częściowych elementów.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

Wartość właściwości

true, jeśli zmienia rozmiar kontrolki tak, aby nie wyświetlała częściowych elementów; w przeciwnym razie false.true if the control resizes so that it does not display partial items; otherwise, false. Wartość domyślna to true.The default is true.

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

Gdy ta właściwość ma wartość true, formant automatycznie zmienia rozmiar, aby upewnić się, że element nie jest częściowo wyświetlany.When this property is set to true, the control automatically resizes to ensure that an item is not partially displayed. Jeśli chcesz zachować oryginalny rozmiar ListBox w oparciu o wymagania dotyczące miejsca w formularzu, ustaw tę właściwość na 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.

Domyślnie ListBox i rozmiary CheckedListBox są takie same, aby pokazywały tylko całe elementy.By default, the ListBox and the CheckedListBox sizes are such that they show only whole items. Jeśli chcesz, aby ListBox lub CheckedListBox całkowicie wypełnić zadokowany obszar, ustaw IntegralHeight na false.If you want the ListBox or CheckedListBox to completely fill a docked area, set IntegralHeight to false. Powoduje to całkowite wypełnienie obszaru przez formant, ale ostatni element nie jest w pełni wyświetlany.This causes the control to completely fill the area, but the last item is not fully displayed.

Jeśli ListBox nie zawiera żadnych elementów, ta właściwość nie ma żadnego wpływu.If the ListBox does not contain any items, this property has no effect.

Uwaga

Wysokość całkowity jest oparta na wysokości ListBox, a nie na wysokości obszaru klienta.The integral height is based on the height of the ListBox, rather than the client area height. W związku z tym, gdy właściwość IntegralHeight jest ustawiona true, elementy można nadal pokazać częściowo, jeśli są wyświetlane paski przewijania.As a result, when the IntegralHeight property is set true, items can still be partially shown if scroll bars are displayed.

Uwaga

Jeśli właściwość DrawMode jest ustawiona na DrawMode.OwnerDrawVariable, ta właściwość nie ma żadnego wpływu.If the DrawMode property is set to DrawMode.OwnerDrawVariable, this property has no effect.

Dotyczy

Zobacz też