Win32::Window

Ruby interface to the Win32 window management APIs.

Getting Started

gem install win32-window --pre
require 'win32/window'
include Win32 (optional)

By handle. If the handle does not refer to a window, nil is returned.

w = Window.from_handle(h)

By screen coordinates. Returns the top-level window covering the specified coordinates.

w = Window.from_point(x, y)

# Alternatively:
p = Point.new(x, y)
w = Window.from_point(p)

By window title. Returns all top-level windows whose title matches the specified regex. This can return multiple windows.

w = Window.find(:title => /calculator/i)

# Get just the first result.
w = Window.find(:title => /Google Chrome$/).first

By process ID. Returns all top-level windows owned by the specified process ID. This can return multiple windows.

w = Window.find(:pid => 4242)

By custom filter. Returns all top-level windows for which the block holds true. This can return multiple windows.

w = Window.find { |pid, title|
  (pid > 1000) && (title.end_with? 'Notepad')
}

The desktop window. Note that the geometry of this window corresponds to the primary monitor only.

w = Window.desktop

The foreground window. This is the window with which the user is currently working.

w = Window.foreground

w.parent

w.child_of?

w.handle

w.title

w.pid

w.size ...

w.client.size ...

w.resize(...)

w.move(...)

w.minimized?, w.minimize

w.maximized?, w.maximize

w.foreground?, w.foregroundize

w.restore

w.visible?, w.hide, w.show

w.topmost?, w.topmost=