Control.ClientSize Eigenschap

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

Waarde van eigenschap

Een Size die de dimensies van het clientgebied van het besturingselement vertegenwoordigt.

Kenmerken

BrowsableAttribute

Voorbeelden

In het volgende codevoorbeeld wordt de grootte van het opgegeven besturingselement aangepast, zodat het besturingselement geschikt is voor de opgemaakte tekst. De opgemaakte tekst is de Text eigenschap waaraan het besturingselement is toegewezen Font , toegepast op de tekst. De AutoSizeControl methode in dit voorbeeld bevat ook een textPadding parameter die de opvulling aangeeft die moet worden toegepast op alle randen van het besturingselement. Als u de opvulling gelijk wilt maken, lijnt u de tekst uit met de ContentAlignment.MiddleCenter waarde als uw besturingselement dit ondersteunt.

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

Opmerkingen

Het clientgebied van een besturingselement is de grenzen van het besturingselement, minus de niet-clientelementen, zoals schuifbalken, randen, titelbalken en menu's. De SetClientSizeCore methode wordt aangeroepen om de ClientSize eigenschap in te stellen. De ClientSize eigenschap wordt niet altijd gewijzigd via set de methode, dus u moet de SetClientSizeCore methode overschrijven om ervoor te zorgen dat uw code wordt uitgevoerd wanneer de ClientSize eigenschap is ingesteld.

De Size.Width en Size.Height eigenschappen vertegenwoordigen de breedte en hoogte van het clientgebied van het besturingselement. U kunt deze eigenschap gebruiken om de grootte van het clientgebied van het besturingselement te verkrijgen voor taken zoals tekenen op het oppervlak van het besturingselement.

Zie Rendering a Windows Forms Control voor meer informatie over het tekenen van besturingselementen.

Zie ook

• ClientRectangle
• DrawMode