Control.ClientRectangle-Eigenschaft
Ruft das Rechteck ab, das den Clientbereich des Steuerelements darstellt.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
Public ReadOnly Property ClientRectangle As Rectangle
'Usage
Dim instance As Control
Dim value As Rectangle
value = instance.ClientRectangle
public Rectangle ClientRectangle { get; }
public:
property Rectangle ClientRectangle {
Rectangle get ();
}
/** @property */
public Rectangle get_ClientRectangle ()
public function get ClientRectangle () : Rectangle
Eigenschaftenwert
Ein Rectangle, das den Clientbereich des Steuerelements darstellt.
Hinweise
Der Clientbereich eines Steuerelements entspricht den Begrenzungen des Steuerelements abzüglich der Nicht-Clientelemente, z. B. Bildlaufleisten, Rahmen, Titelleisten und Menüs.
Da die Clientkoordinaten relativ zur linken oberen Ecke des Clientbereichs des Steuerelements angegeben werden, sind die von dieser Eigenschaft zurückgegebenen Koordinaten für die linke obere Ecke des Rechtecks (0,0). Mithilfe dieser Eigenschaft können Sie Größe und Koordinaten des Clientbereichs des Steuerelements für Aufgaben wie das Zeichnen auf der Oberfläche des Steuerelements abrufen.
Weitere Informationen zum Zeichnen auf Steuerelementen finden Sie unter Wiedergeben eines Windows Forms-Steuerelements.
Beispiel
Im folgenden Codebeispiel wird der automatische Bildlauf für ein Formular aktiviert, die Größe des Formulars geändert und gewährleistet, dass eine Schaltfläche weiterhin angezeigt wird, nachdem die Größe des Formulars geändert wurde. Bei diesem Beispiel muss in einem Form ein Button mit der Bezeichnung button2
vorhanden sein.
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
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 void ResizeForm()
{
// Enable auto-scrolling for the form.
this.set_AutoScroll(true);
// Resize the form.
Rectangle r = this.get_ClientRectangle();
// Subtract 100 pixels from each side of the Rectangle.
r.Inflate(-100, -100);
this.set_Bounds(this.RectangleToScreen(r));
// Make sure button2 is visible.
this.ScrollControlIntoView(button2);
} //ResizeForm
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
Control-Klasse
Control-Member
System.Windows.Forms-Namespace
ClientSize
DrawMode