ListBox.IntegralHeight Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit une valeur indiquant si le contrôle doit être redimensionné pour éviter d'afficher des éléments partiels.

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

Valeur de propriété

Boolean

true si le contrôle est redimensionné de manière qu'il n'affiche pas partiellement des éléments ; sinon, false. La valeur par défaut est true.

Exemples

L’exemple de code suivant montre comment utiliser les HorizontalScrollbar propriétés et HorizontalExtent pour afficher une barre de défilement horizontale qui affiche tout le texte d’élément dans le ListBox contrôle. L’exemple utilise également la IntegralHeight propriété pour s’assurer que les éléments ne sont pas partiellement affichés en raison de la taille du ListBox contrôle. Cet exemple nécessite qu’un ListBox contrôle, nommé listBox1, ait été ajouté à un formulaire.

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

Remarques

Lorsque cette propriété a la truevaleur , le contrôle se redimensionne automatiquement pour s’assurer qu’un élément n’est pas partiellement affiché. Si vous souhaitez conserver la taille d’origine du en fonction de ListBox l’espace requis de votre formulaire, définissez cette propriété sur false.

Par défaut, les ListBoxCheckedListBox tailles et sont telles qu’elles n’affichent que des éléments entiers. Si vous souhaitez que le ListBox ou remplisse complètement une zone d’ancrage, définissez sur IntegralHeightfalse.CheckedListBox Cela entraîne le remplissage complet du contrôle, mais le dernier élément n’est pas entièrement affiché.

Si le ListBox ne contient aucun élément, cette propriété n’a aucun effet.

Notes

La hauteur intégrale est basée sur la hauteur de , ListBoxplutôt que sur la hauteur de la zone cliente. Par conséquent, lorsque la IntegralHeight propriété est définie true, les éléments peuvent toujours être partiellement affichés si des barres de défilement sont affichées.

Notes

Si la propriété a la DrawModeDrawMode.OwnerDrawVariablevaleur , cette propriété n’a aucun effet.

Voir aussi

• DrawMode