ListBox.IntegralHeight Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ListBox.cs

Získá nebo nastaví hodnotu určující, zda má ovládací prvek změnit velikost, aby se zabránilo zobrazení částečných položek.

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

Hodnota vlastnosti

Boolean

truepokud ovládací prvek změní velikost tak, aby nezobrazovat částečné položky; v opačném případě . false Výchozí hodnota je true.

Příklady

Následující příklad kódu ukazuje použití HorizontalScrollbar a HorizontalExtent vlastnosti k zobrazení vodorovného posuvníku, který zobrazuje veškerý text položky v ovládacím ListBox prvku. Příklad také používá IntegralHeight vlastnost k zajištění, že položky nejsou částečně zobrazeny kvůli velikosti ListBox ovládacího prvku. Tento příklad vyžaduje přidání ListBox ovládacího prvku s názvem listBox1do formuláře.

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

Poznámky

Pokud je tato vlastnost nastavena na true, ovládací prvek automaticky změní velikost, aby se zajistilo, že položka není částečně zobrazena. Chcete-li zachovat původní velikost ListBox na základě požadavků na místo ve formuláři, nastavte tuto vlastnost na falsehodnotu .

Ve výchozím nastavení jsou velikosti ListBoxCheckedListBox tak, aby zobrazovaly pouze celé položky. Chcete-li ListBox nebo CheckedListBox zcela vyplnit ukotvenou oblast, nastavte na IntegralHeighthodnotu false . To způsobí, že ovládací prvek zcela vyplní oblast, ale poslední položka není úplně zobrazena.

Pokud neobsahuje ListBox žádné položky, tato vlastnost nemá žádný vliv.

Note

Integrální výška je založena na výšce ListBox, nikoli na výšku klientské oblasti. V důsledku toho, když IntegralHeight je vlastnost nastavena true, položky mohou být stále částečně zobrazeny, pokud jsou zobrazeny posuvníky.

Note

Pokud je vlastnost nastavena DrawMode na DrawMode.OwnerDrawVariable, tato vlastnost nemá žádný vliv.

Viz také

• DrawMode