Control.ClientSize Control.ClientSize Control.ClientSize Control.ClientSize Property

Definizione

Ottiene o imposta l'altezza e la larghezza dell'area client del controllo.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; }
member this.ClientSize : System.Drawing.Size with get, set
Public Property ClientSize As Size

Valore della proprietà

Oggetto Size che rappresenta le dimensioni dell'area client del controllo.A Size that represents the dimensions of the client area of the control.

Esempi

Nell'esempio di codice seguente viene ridimensionato il controllo specificato, in modo che il controllo possa contenere il testo formattato.The following code example resizes the specified control so the control will accommodate its formatted text. Il testo formattato è Text la proprietà con l'oggetto assegnato Font del controllo applicato al testo.The formatted text is the Text property with the control's assigned Font applied to the text. Il AutoSizeControl metodo in questo esempio dispone anche di textPadding un parametro che rappresenta la spaziatura interna da applicare a tutti i bordi del controllo.The AutoSizeControl method in this example also has a textPadding parameter that represents the padding to apply to all edges of the control. Per fare in modo che la spaziatura interna appaia uguale, ContentAlignment.MiddleCenter allineare il testo con il valore, se il controllo lo supporta.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

Commenti

L'area client di un controllo è costituita dai limiti del controllo, meno gli elementi non client come le barre di scorrimento, i bordi, le barre del titolo e 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. Il SetClientSizeCore metodo viene chiamato per impostare la ClientSize proprietà.The SetClientSizeCore method is called to set the ClientSize property. La ClientSize proprietà non viene sempre modificata tramite il set relativo metodo, pertanto è necessario SetClientSizeCore eseguire l'override del metodo per assicurarsi che il codice ClientSize venga eseguito quando la proprietà è impostata.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.

Le Size.Width proprietà Size.Height e rappresentano la larghezza e l'altezza dell'area client del controllo.The Size.Width and Size.Height properties represent the width and height of the client area of the control. È possibile utilizzare questa proprietà per ottenere le dimensioni dell'area client del controllo per attività quali il disegno sulla superficie del controllo.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.

Per ulteriori informazioni sul disegno dei controlli, vedere rendering di un controllo Windows Forms.For more information about drawing on controls, see Rendering a Windows Forms Control.

Nota

Non è possibile associare le impostazioni dell'applicazione a questa proprietà.You cannot bind application settings to this property. Per ulteriori informazioni sulle impostazioni dell'applicazione, vedere Cenni preliminari sulle impostazioni delle applicazioni.For more information on application settings, see Application Settings Overview.

Si applica a

Vedi anche