Struct WindowsWindow

Source

pub struct WindowsWindow(/* private fields */);

Expand description

Represents a window in the Windows platform.

Implementations§

Source §

impl WindowsWindow

Source

pub fn new(hwnd: HWND) -> Self

Creates a new WindowsWindow from a raw HWND.

§Warning

You must ensure that the hwnd is a valid window handle. If you pass an invalid handle, it may lead to errors on methods. You can use get_window to safely retrieve a WindowsWindow.

Source

pub fn hwnd(&self) -> HWND

Returns the raw handle to the window.

Examples found in repository ?

examples/windows_various_rect.rs (line 11)

7fn main() {
8    for window in window_getter::get_windows().unwrap() {
9        let window = window.into_platform_window();
10
11        println!("\n{:?} ({:?})", window.title(), window.hwnd());
12        println!("\tGetWindowRect: {:?}", window.rect());
13        println!(
14            "\tDwmGetWindowAttribute with DWMWA_EXTENDED_FRAME_BOUNDS: {:?}",
15            window.extended_frame_bounds()
16        );
17    }
18}

Source

pub fn title(&self) -> Result<Option<String>, WindowsError>

Returns the title of the window.

Examples found in repository ?

examples/windows_various_rect.rs (line 11)

7fn main() {
8    for window in window_getter::get_windows().unwrap() {
9        let window = window.into_platform_window();
10
11        println!("\n{:?} ({:?})", window.title(), window.hwnd());
12        println!("\tGetWindowRect: {:?}", window.rect());
13        println!(
14            "\tDwmGetWindowAttribute with DWMWA_EXTENDED_FRAME_BOUNDS: {:?}",
15            window.extended_frame_bounds()
16        );
17    }
18}

Source

pub fn rect(&self) -> Result<RECT, WindowsError>

Returns the raw rectangle of the window by [GetWindowRect].

It includes the invisible resize borders. So it may not be the same as the window rectangle that is actually seen.

Examples found in repository ?

examples/windows_various_rect.rs (line 12)

7fn main() {
8    for window in window_getter::get_windows().unwrap() {
9        let window = window.into_platform_window();
10
11        println!("\n{:?} ({:?})", window.title(), window.hwnd());
12        println!("\tGetWindowRect: {:?}", window.rect());
13        println!(
14            "\tDwmGetWindowAttribute with DWMWA_EXTENDED_FRAME_BOUNDS: {:?}",
15            window.extended_frame_bounds()
16        );
17    }
18}

Source

pub fn bounds(&self) -> Result<Bounds, WindowsError>

This will return rect value wrapped in WindowsBounds.

Source

pub fn extended_frame_bounds(&self) -> Result<RECT, WindowsError>

Returns the extended frame bounds of the window by [DwmGetWindowAttribute] with [DWMWA_EXTENDED_FRAME_BOUNDS].

Examples found in repository ?

examples/windows_various_rect.rs (line 15)

7fn main() {
8    for window in window_getter::get_windows().unwrap() {
9        let window = window.into_platform_window();
10
11        println!("\n{:?} ({:?})", window.title(), window.hwnd());
12        println!("\tGetWindowRect: {:?}", window.rect());
13        println!(
14            "\tDwmGetWindowAttribute with DWMWA_EXTENDED_FRAME_BOUNDS: {:?}",
15            window.extended_frame_bounds()
16        );
17    }
18}