moveTo method

[This documentation is preliminary and is subject to change.]

Applies to: desktop apps only

Moves the screen position of the upper-left corner of the window to the specified x and y position.

This method is not supported for Metro style apps using JavaScript.

Syntax

HRESULT retVal = object.moveTo(x, y);

Standards information

There are no standards that apply here.

Parameters

  • x [in]
    Type: long

    long that specifies the horizontal scroll offset in pixels. The value can be either positive or negative.

  • y [in]
    Type: long

    long that specifies the vertical scroll offset in pixels. The value can be either positive or negative.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method is not valid with windows created using the showModalDialog or showModelessDialog methods. In order to move or resize a dialog window created with these methods, change the dialogHeight, dialogWidth, dialogTop, and dialogLeft properties.

If the page (that contains this script) is hosted within an IFRAME, the IFRAME will move relative to the upper-left corner of the content area.

Windows XP Service Pack 2 (SP2) or later. Windows that are located in the Internet Zone are subject to Window_Restrictions and will be forced to stay on screen. This applies to moveTo, moveBy, resizeTo, and resizeBy methods.

Note  When operating in high-dpi mode, pixel values are scaled up accordingly. See Adjusting Scale for Higher DPI Screens for additional information.

Windows Internet Explorer 7. This method is only effective when a single tab is open or when tabbed browsing is disabled. If multiple tabs are open, this method is blocked. For information regarding tab interaction from a script, see Tabbed Browsing for Developers.

 

 

Build date: 1/26/2012