Export (0) Print
Expand All

HtmlElementEventArgs.MousePosition Property

Gets or sets the position of the mouse cursor relative to a relatively positioned parent element.

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

public Point MousePosition { get; }

Property Value

Type: System.Drawing.Point
The position of the mouse cursor relative to the upper-left corner of the parent of the element that raised the event, if the parent element is relatively positioned.

Relative positioning is used in HTML to place an element on a page in relation to its parent.

If an element is relatively positioned, this property will return the same result as ClientMousePosition.

The following HTML file demonstrates relative positioning of a TABLE inside of a BODY tag.

<HTML>

<BODY>

    <TABLE style="position:relative;top:100px;left:100px;">
        <TR>
            <TD>Text/TD>
            <TD>More text</TD>
        </TR>
    </TABLE>

</BODY>

</HTML>

The following code example displays the difference between MousePosition, ClientMousePosition, and OffsetMousePosition when the user clicks on an element of the TABLE. ClientMousePosition will display coordinates relative to the upper-left corner of the document's client area. MousePosition will display coordinates relative to the upper-left corner of the TABLE. If you click on one of the lines of text, OffsetMousePosition will display coordinates relative to that TD element.

This example requires that you have configured Document_MouseDown as a handler for the MouseDown event on HtmlDocument.

void Document_Click(object sender, HtmlElementEventArgs e)
{
    HtmlDocument doc = webBrowser1.Document;
    string msg = "ClientMousePosition: " + e.ClientMousePosition.ToString() + "\n" +
        "MousePosition: " + e.MousePosition + "\n" +
        "OffsetMousePosition: " + e.OffsetMousePosition;
    MessageBox.Show(msg);
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft