Control.ClientRectangle Propriedade

Definição

Obtém o retângulo que representa a área cliente do controlo.

public:
 property System::Drawing::Rectangle ClientRectangle { System::Drawing::Rectangle get(); };
[System.ComponentModel.Browsable(false)]
public System.Drawing.Rectangle ClientRectangle { get; }
[<System.ComponentModel.Browsable(false)>]
member this.ClientRectangle : System.Drawing.Rectangle
Public ReadOnly Property ClientRectangle As Rectangle

Valor de Propriedade

A Rectangle que representa a área cliente do controlo.

Atributos

Exemplos

O exemplo de código seguinte permite o auto-scrolling de um formulário, redimensiona o formulário e garante que um botão permanece visível após o redimensionamento do formulário. Este exemplo exige que tenhas um Form nome com Buttonbutton2 um nome.

private:
   void ResizeForm()
   {
      
      // Enable auto-scrolling for the form.
      this->AutoScroll = true;
      
      // Resize the form.
      Rectangle r = this->ClientRectangle;
      
      // Subtract 100 pixels from each side of the Rectangle.
      r.Inflate(  -100, -100 );
      this->Bounds = this->RectangleToScreen( r );
      
      // Make sure button2 is visible.
      this->ScrollControlIntoView( button2 );
   }
private void ResizeForm()
{
   // Enable auto-scrolling for the form.
   this.AutoScroll = true;

   // Resize the form.
   Rectangle r = this.ClientRectangle;
   // Subtract 100 pixels from each side of the Rectangle.
   r.Inflate(-100, -100);
   this.Bounds = this.RectangleToScreen(r);

   // Make sure button2 is visible.
   this.ScrollControlIntoView(button2);
}
Private Sub ResizeForm()
   ' Enable auto-scrolling for the form.
   Me.AutoScroll = True
   
   ' Resize the form.
   Dim r As Rectangle = Me.ClientRectangle
   ' Subtract 100 pixels from each side of the Rectangle.
   r.Inflate(- 100, - 100)
   Me.Bounds = Me.RectangleToScreen(r)
   
   ' Make sure button2 is visible.
   Me.ScrollControlIntoView(button2)
End Sub

Observações

A área cliente de um controlo é os limites do controlo, excluindo os elementos não clientes como barras de scroll, bordas, barras de título e menus.

Como as coordenadas cliente são relativas ao canto superior esquerdo da área cliente do controlo, as coordenadas do canto superior esquerdo do retângulo devolvido por esta propriedade são (0,0). Pode usar esta propriedade para obter o tamanho e as coordenadas da área cliente do controlo para tarefas como desenhar na superfície do controlo.

Para mais informações sobre desenhar em controlos, veja Rendering a Windows Forms Control.

Aplica-se a

Ver também