HtmlElement.OffsetRectangle Property (System.Windows.Forms)

OffsetRectangle Property

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2010/.NET Framework 4

Other versions are also available for the following:

.NET Framework Class Library

HtmlElement..::.OffsetRectangle Property

Gets the location of an element relative to its parent.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

Syntax

Visual Basic

Public ReadOnly Property OffsetRectangle As Rectangle

public Rectangle OffsetRectangle { get; }

Visual C++

public:
property Rectangle OffsetRectangle {
    Rectangle get ();
}

member OffsetRectangle : Rectangle

Property Value

Type: System.Drawing..::.Rectangle
The x- and y-coordinate positions of the element, and its width and its height, in relation to its parent.
If an element's parent is relatively or absolutely positioned, OffsetRectangle will return the offset of the parent element. If the element itself is relatively positioned with respect to its parent, OffsetRectangle will return the offset from its parent.

Remarks

Elements can be positioned on an HTML page in one of three ways:

Default flow positioning.
Relative positioning, in which the element is offset by a fixed amount relative to its parent.
Absolute positioning, in which the element is given a fixed coordinate position relative to the upper-left corner of the document.

For more information about element positioning in HTML, see About Element Positioning.

Examples

The following code example shows how OffsetParent and OffsetRectangle differ for span1, span2 and span3:

<HTML>
    <BODY id="documentBody">

        <DIV id="div1">
            <SPAN id="span1">Placeholder text 1.</SPAN>
        </DIV>

        <DIV id="div2" style="position:relative;top:100px;left:100px;">
            <SPAN id="span2">Placeholder text 2.</SPAN>
        </DIV>

        <DIV id="div3" style="position:absolute;top:200px;left:200px;">
            <DIV id="div4" style="position:relative;top:100px;left:100px;">
                <SPAN id="span3">Placeholder text 3.</SPAN>
            </DIV>
        </DIV>

    </BODY>
</HTML>

Visual Basic

Private Sub GetOffsets()
    Dim Str As String = ""
    Dim Doc As HtmlDocument = WebBrowser1.Document

    For Each Elem As HtmlElement In Doc.GetElementsByTagName("SPAN")
        Str &= "OffsetParent for " & Elem.Id & " is " & Elem.OffsetParent.Id
        Str &= "; OffsetRectangle is " & Elem.OffsetRectangle.ToString() & vbCrLf
    Next

    MessageBox.Show(Str)
End Sub

        private void GetOffsets()
        {
            String str = "";
            HtmlDocument doc = webBrowser1.Document;

            foreach (HtmlElement elem in doc.GetElementsByTagName("SPAN"))
            {
                str += "OffsetParent for " + elem.Id + " is " + elem.OffsetParent.Id;
                str += "; OffsetRectangle is " + elem.OffsetRectangle.ToString() + "\n";
            }

            MessageBox.Show(str);
        }

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

HtmlElement Class

System.Windows.Forms Namespace

OffsetParent

Other Resources

offsetLeft Property

offsetTop Property

offsetWidth Property

offsetHeight Property

Measuring Element Dimension and Location