ListBox.IntegralHeight Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob die Größe des Steuerelements automatisch so angepasst wird, dass keine Elemente abgeschnitten werden, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, wenn die Größe des Steuerelements so angepasst wird, dass keine Elemente abgeschnitten werden, andernfalls false. Der Standardwert ist true.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die HorizontalScrollbar Eigenschaften und HorizontalExtent verwendet werden, um eine horizontale Bildlaufleiste anzuzeigen, die ListBox den gesamten Elementtext im 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 muss einem Formular ein ListBox Steuerelement mit dem Namen listBox1hinzugefügt werden.

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

Wenn diese Eigenschaft auf truefestgelegt ist, ändert sich die Größe des Steuerelements automatisch, um sicherzustellen, dass ein Element nicht teilweise angezeigt wird. Wenn Sie die ursprüngliche Größe des ListBox basierend auf den Platzanforderungen Ihres Formulars beibehalten möchten, legen Sie diese Eigenschaft auf fest false.

Standardmäßig sind die ListBox Größen und CheckedListBox so, dass nur ganze Elemente angezeigt werden. Wenn oder einen angedockten Bereich vollständig ausfüllen soll ListBoxCheckedListBox , legen Sie auf fest IntegralHeightfalse. Dadurch füllt das Steuerelement den Bereich vollständig aus, aber das letzte Element wird nicht vollständig angezeigt.

Wenn die ListBox keine Elemente enthält, hat diese Eigenschaft keine Auswirkungen.

Hinweis

Die integrale Höhe basiert auf der Höhe des ListBox- und nicht auf der Höhe des Clientbereichs. Daher können Elemente, wenn die IntegralHeight -Eigenschaft festgelegt trueist, weiterhin teilweise angezeigt werden, wenn Bildlaufleisten angezeigt werden.

Hinweis

Wenn die DrawMode -Eigenschaft auf DrawMode.OwnerDrawVariablefestgelegt ist, hat diese Eigenschaft keine Auswirkungen.

Weitere Informationen

• DrawMode