Share via

HtmlElement.ClientRectangle Eigenschaft

  • Referenz

Definition

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

Ruft die Grenzen des Clientbereichs des Elements im HTML-Dokument ab.

public:
 property System::Drawing::Rectangle ClientRectangle { System::Drawing::Rectangle get(); };
public System.Drawing.Rectangle ClientRectangle { get; }
member this.ClientRectangle : System.Drawing.Rectangle
Public ReadOnly Property ClientRectangle As Rectangle

Eigenschaftswert

Rectangle

Der vom Element eingenommene Clientbereich, abzüglich aller von Rahmen und Bildlaufleisten eingenommenen Bereiche. Wenn Sie die Position und die Dimensionen des Elements einschließlich seiner Zusatzelemente abrufen möchten, verwenden Sie stattdessen OffsetRectangle.

Beispiele

Angenommen, Sie haben die folgende HTML-Seite in eine gehostete Instanz des WebBrowser Steuerelements geladen.

<HTML>  

    <BODY>  

        <DIV id="div1" style="position:absolute;top:100px;left:100px;border-      style:solid;border-width:1px;">  
            Edit this text.  
        </DIV>  

    </BODY>  

</HTML>

Im folgenden Codebeispiel wird veranschaulicht, dass dieses Element abgerufen und die Dimensionen erweitert werden, wenn der Clientbereich kleiner als 400 Pixel breit um 50 Pixel hoch ist, und legt auch den DIV contentEditable Zustand fest, damit der Benutzer Text eingeben kann.

private void EnableEditing()
{
    if (webBrowser1.Document != null)
    {
        HtmlElement elem = webBrowser1.Document.GetElementById("div1");
        if (elem != null)
        {
            if (elem.ClientRectangle.Width < 200)
            {
                elem.SetAttribute("width", "200px");
            }

            if (elem.ClientRectangle.Height < 50)
            {
                elem.SetAttribute("height", "50px");
            }

            elem.SetAttribute("contentEditable", "true");
            //elem.SetFocus();
        }
    }
}

Private Sub EnableEditing()
    Dim Elem As HtmlElement = WebBrowser1.Document.GetElementById("div1")
    If (Not Elem Is Nothing) Then
        If (Elem.ClientRectangle.Width < 200) Then
            Elem.SetAttribute("width", "200px")
        End If

        If (Elem.ClientRectangle.Height < 50) Then
            Elem.SetAttribute("height", "50px")
        End If

        Elem.SetAttribute("contentEditable", "true")
        Elem.Focus()
    End If
End Sub

Hinweise

ClientRectangle Gibt Positionsdaten nur für Elemente zurück, die einer expliziten Höhe und Breite zugewiesen wurden, oder Elemente, die absolute Positionierung verwenden. Ein Dokument ist absolut positioniert, wenn der Positionsstil auf festgelegt ist absolute, nachdem er auf eine beliebige Koordinate auf der HTML-Seite positioniert werden kann.

Gilt für

Siehe auch