resizeBy method

Changes the current size of the window by the specified x- and y-offset.


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


  • x [in]
    Type: long

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

  • y [in]
    Type: long

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

Return value


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

Standards information

There are no standards that apply here.


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.

See also