Sdílet prostřednictvím


Control.ClientSize Vlastnost

Definice

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

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é