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。それ以外の場合は falsetrue 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. ドッキング領域を完全にCheckedListBox塗りつぶすにIntegralHeight falseは、をに設定します。 ListBoxIf 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.

注意

プロパティがDrawModeDrawMode.OwnerDrawVariable設定されている場合、このプロパティは無効です。If the DrawMode property is set to DrawMode.OwnerDrawVariable, this property has no effect.

適用対象

こちらもご覧ください