Control.ClientRectangle Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

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 da propriedade

Rectangle

Um Rectangle que representa a área de cliente do controle.

Atributos
BrowsableAttribute

Exemplos

O exemplo de código a seguir habilita a rolagem automática para um formulário, redimensiona o formulário e garante que um botão permaneça visível depois que o formulário for redimensionado. Este exemplo requer que você tenha um Form nomeButton.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 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

Comentários

A área do cliente de um controle é os limites do controle, menos os elementos nãoclientes, como barras de rolagem, bordas, barras de título e menus.

Como as coordenadas do cliente são relativas ao canto superior esquerdo da área do cliente do controle, as coordenadas do canto superior esquerdo do retângulo retornado por essa propriedade são (0,0). Você pode usar essa propriedade para obter o tamanho e as coordenadas da área do cliente do controle para tarefas como desenhar na superfície do controle.

Para obter mais informações sobre como desenhar em controles, consulte Renderizando um controle de Windows Forms.

Aplica-se a

Confira também