Control.ClientSize Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia wysokość i szerokość obszaru klienta kontrolki.

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

Wartość właściwości

Size

Element Size reprezentujący wymiary obszaru klienta kontrolki.

Atrybuty

BrowsableAttribute

Przykłady

Poniższy przykład kodu zmienia rozmiar określonej kontrolki, aby kontrolka pomieściła sformatowany tekst. Sformatowany tekst jest Text właściwością z przypisaną kontrolką do Font tekstu. Metoda AutoSizeControl w tym przykładzie zawiera textPadding również parametr reprezentujący dopełnienie do zastosowania do wszystkich krawędzi kontrolki. Aby ustawić, że dopełnienie jest równe, wyrównaj tekst do ContentAlignment.MiddleCenter wartości, jeśli kontrolka ją obsługuje.

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

Uwagi

Obszar klienta kontrolki to granice kontrolki, minus elementy nieklientne, takie jak paski przewijania, obramowania, paski tytułu i menu. Metoda jest wywoływana SetClientSizeCore w celu ustawienia ClientSize właściwości . Właściwość ClientSize nie zawsze jest zmieniana za pomocą set metody , dlatego należy zastąpić SetClientSizeCore metodę, aby upewnić się, że kod jest wykonywany po ClientSize ustawieniu właściwości.

Właściwości Size.Width i Size.Height reprezentują szerokość i wysokość obszaru klienta kontrolki. Tej właściwości można użyć do uzyskania rozmiaru obszaru klienta kontrolki dla zadań, takich jak rysowanie na powierzchni kontrolki.

Aby uzyskać więcej informacji na temat rysowania kontrolek, zobacz Renderowanie kontrolki Windows Forms.

Uwaga

Nie można powiązać ustawień aplikacji z tą właściwością. Aby uzyskać więcej informacji na temat ustawień aplikacji, zobacz Omówienie ustawień aplikacji.

Zobacz też

• ClientRectangle
• DrawMode