moveBy method

Moves the screen position of the window by the specified x and y offset values.

Syntax

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

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.

Standards information

There are no standards that apply here.

Remarks

This method is not valid with windows created using the IHTMLWindow2::showModalDialog or IHTMLWindow3::showModelessDialog methods. In order to move or resize a dialog window created with these methods, change the IHTMLDialog::dialogHeight, IHTMLDialog::dialogWidth, IHTMLDialog::dialogTop, and IHTMLDialog::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 IHTMLWindow2::moveTo, IHTMLWindow2::moveBy, IHTMLWindow2::resizeTo, and IHTMLWindow2::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.