Sdílet prostřednictvím

Control.ClientSize Vlastnost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Získá nebo nastaví výšku a šířku klientské oblasti ovládacího prvku.

public:
 property System::Drawing::Size ClientSize { System::Drawing::Size get(); void set(System::Drawing::Size value); };
[System.ComponentModel.Browsable(false)]
public System.Drawing.Size ClientSize { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.ClientSize : System.Drawing.Size with get, set
Public Property ClientSize As Size

Hodnota vlastnosti

Size

A Size , který představuje rozměry klientské oblasti ovládacího prvku.

Atributy
BrowsableAttribute

Příklady

Následující příklad kódu změní velikost zadaného ovládacího prvku tak, aby ovládací prvek přizpůsobil jeho formátovaný text. Formátovaný text je Text vlastnost s přiřazeným Font ovládacím prvku použitým pro text. Metoda AutoSizeControl v tomto příkladu má textPadding také parametr, který představuje odsazení, které se použije u všech okrajů ovládacího prvku. Pokud chcete, aby se odsazení zobrazilo stejně, zarovnejte text s hodnotou, pokud ho ContentAlignment.MiddleCenter ovládací prvek podporuje.

private:
   void AutoSizeControl( Control^ control, int textPadding )
   {
      
      // Create a Graphics object for the Control.
      Graphics^ g = control->CreateGraphics();
      
      // Get the Size needed to accommodate the formatted Text.
      System::Drawing::Size preferredSize = g->MeasureString( control->Text, control->Font ).ToSize();
      
      // Pad the text and resize the control.
      control->ClientSize = System::Drawing::Size( preferredSize.Width + (textPadding * 2), preferredSize.Height + (textPadding * 2) );
      
      // Clean up the Graphics object.
      delete g;
   }

private void AutoSizeControl(Control control, int textPadding)
{
   // Create a Graphics object for the Control.
   Graphics g = control.CreateGraphics();

   // Get the Size needed to accommodate the formatted Text.
   Size preferredSize = g.MeasureString(
      control.Text, control.Font).ToSize();

   // Pad the text and resize the control.
   control.ClientSize = new Size(
      preferredSize.Width + (textPadding * 2), 
      preferredSize.Height+(textPadding * 2) );

   // Clean up the Graphics object.
   g.Dispose();
}

Private Sub AutoSizeControl(control As Control, textPadding As Integer)
   ' Create a Graphics object for the Control.
   Dim g As Graphics = control.CreateGraphics()
   
   ' Get the Size needed to accommodate the formatted Text.
   Dim preferredSize As Size = g.MeasureString( _
     control.Text, control.Font).ToSize()
   
   ' Pad the text and resize the control.
   control.ClientSize = New Size( _
     preferredSize.Width + textPadding * 2, _
     preferredSize.Height + textPadding * 2)
   
   ' Clean up the Graphics object.
   g.Dispose()
End Sub

Poznámky

Klientská oblast ovládacího prvku je hranice ovládacího prvku, mínus prvky bez klienta, jako jsou posuvníky, ohraničení, záhlaví a nabídky. Metoda SetClientSizeCore je volána k nastavení ClientSize vlastnosti. Vlastnost ClientSize není vždy změněna prostřednictvím jeho set metody, takže byste měli přepsat metodu SetClientSizeCore , aby se zajistilo, že se kód spustí při ClientSize nastavení vlastnosti.

Size.Height Vlastnosti Size.Width představují šířku a výšku klientské oblasti ovládacího prvku. Tuto vlastnost můžete použít k získání velikosti klientské oblasti ovládacího prvku pro úlohy, jako je kreslení na povrchu ovládacího prvku.

Další informace o kreslení na ovládacích prvcích naleznete v tématu Vykreslování ovládacího prvku model Windows Forms.

Poznámka

Nastavení aplikace nelze svázat s touto vlastností. Další informace o nastavení aplikace najdete v tématu Přehled nastavení aplikace.

Platí pro

Viz také