ListBox.IntegralHeight Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu označ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
true
Pokud ovládací prvek změní velikost tak, aby nezobrazovat částečné položky; v opačném případě . false
Výchozí formát je true
.
Příklady
Následující příklad kódu ukazuje, jak použít HorizontalScrollbar vlastnosti a HorizontalExtent k zobrazení vodorovného posuvníku, který zobrazuje veškerý text položky v ovládacím ListBox prvku. V příkladu IntegralHeight se také používá vlastnost k zajištění toho, aby se položky kvůli velikosti ListBox ovládacího prvku nezobrazovat částečně. Tento příklad vyžaduje, aby ListBox byl do formuláře přidán ovládací prvek s názvem 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
Poznámky
Pokud je tato vlastnost nastavená na true
, změní se velikost ovládacího prvku automaticky, aby se zajistilo, že se položka nezobrazí částečně. Pokud chcete zachovat původní velikost objektu ListBox na základě požadavků formuláře na místo, nastavte tuto vlastnost na false
hodnotu .
Ve výchozím nastavení jsou velikosti a CheckedListBox takové, ListBox že zobrazují jenom celé položky. Pokud chcete ListBox , aby nebo CheckedListBox zcela vyplnily ukotvenou oblast, nastavte IntegralHeight na false
. To způsobí, že ovládací prvek zcela vyplní oblast, ale poslední položka se nezobrazí úplně.
Pokud neobsahuje ListBox žádné položky, nemá tato vlastnost žádný vliv.
Poznámka
Integrální výška je založena na výšce objektu ListBox, nikoli na výšce klientské oblasti. Výsledkem je, že když IntegralHeight je vlastnost nastavená true
, položky se dají zobrazit částečně, pokud jsou zobrazeny posuvníky.
Poznámka
Pokud je vlastnost nastavena DrawMode na DrawMode.OwnerDrawVariable
, nemá tato vlastnost žádný vliv.