Control.ClientSize Właściwość

Definicja

Pobiera lub ustawia wysokość i szerokość obszaru klienckiego kontrolki.Gets or sets the height and width of the client area of the control.

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

SizeReprezentujący wymiary obszaru klienckiego kontrolki.A Size that represents the dimensions of the client area of the control.

Atrybuty

Przykłady

Poniższy przykład kodu zmienia rozmiar określonej kontrolki, aby formant pomieścił swój sformatowany tekst.The following code example resizes the specified control so the control will accommodate its formatted text. Sformatowany tekst to Text Właściwość z przypisanym do tekstu kontrolką Font .The formatted text is the Text property with the control's assigned Font applied to the text. AutoSizeControlMetoda w tym przykładzie ma również textPadding parametr, który reprezentuje uzupełnienie, które ma zostać zastosowane do wszystkich krawędzi formantu.The AutoSizeControl method in this example also has a textPadding parameter that represents the padding to apply to all edges of the control. Aby dopełnienie było równe, Wyrównaj tekst do ContentAlignment.MiddleCenter wartości, Jeśli kontrolka ją obsługuje.To make the padding appear equal, align the text with the ContentAlignment.MiddleCenter value, if your control supports it.

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 jest granicami kontrolki minus elementy nieklienckie, takie jak paski przewijania, obramowania, paski tytułu i menu.The client area of a control is the bounds of the control, minus the nonclient elements such as scroll bars, borders, title bars, and menus. SetClientSizeCoreMetoda jest wywoływana w celu ustawienia ClientSize właściwości.The SetClientSizeCore method is called to set the ClientSize property. ClientSizeWłaściwość nie jest zawsze zmieniana przez jej set metodę, dlatego należy zastąpić SetClientSizeCore metodę, aby upewnić się, że kod jest wykonywany, gdy ClientSize Właściwość jest ustawiona.The ClientSize property is not always changed through its set method so you should override the SetClientSizeCore method to ensure that your code is executed when the ClientSize property is set.

Size.WidthWłaściwości i Size.Height reprezentują szerokość i wysokość obszaru klienckiego kontrolki.The Size.Width and Size.Height properties represent the width and height of the client area of the control. Ta właściwość umożliwia uzyskanie rozmiaru obszaru klienckiego kontrolki dla zadań, takich jak rysowanie na powierzchni formantu.You can use this property to obtain the size of the client area of the control for tasks such as drawing on the surface of the control.

Aby uzyskać więcej informacji na temat rysowania na kontrolkach, zobacz renderowanie kontrolki Windows Forms.For more information about drawing on controls, see Rendering a Windows Forms Control.

Uwaga

Nie można powiązać ustawień aplikacji z tą właściwością.You cannot bind application settings to this property. Aby uzyskać więcej informacji na temat ustawień aplikacji, zobacz Omówienie ustawień aplikacji.For more information on application settings, see Application Settings Overview.

Dotyczy

Zobacz też