Struct Window 

pub struct Window { /* private fields */ }

Represents a window that can be captured.

Example

use windows_capture::window::Window;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let window = Window::foreground()?;
    println!("Foreground window title: {}", window.title()?);

    Ok(())
}

Implementations

impl Window

pub fn foreground() -> Result<Self, Error>

Returns the window that is currently in the foreground.

Errors

Returns Error::NoActiveWindow if there is no foreground window.

pub fn from_name(title: &str) -> Result<Self, Error>

Finds a window by its exact title.

Arguments

• title - The title of the window to find.

Errors

Returns Error::NotFound if no window with the specified title is found.

pub fn from_contains_name(title: &str) -> Result<Self, Error>

Finds a window whose title contains the given substring.

Arguments

• title - The substring to search for in window titles.

Errors

Returns Error::NotFound if no window title contains the specified substring.

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

Returns the title of the window.

Errors

Returns an Error if the window title cannot be retrieved.

pub fn process_id(&self) -> Result<u32, Error>

Returns the process ID of the window.

Errors

Returns an Error if the process ID cannot be retrieved.

pub fn process_name(&self) -> Result<String, Error>

Returns the name of the process that owns the window.

This function requires the PROCESS_QUERY_INFORMATION and PROCESS_VM_READ permissions.

Errors

Returns an Error if the process name cannot be retrieved.

pub fn monitor(&self) -> Option<Monitor>

Returns the monitor that has the largest area of intersection with the window.

Returns None if the window does not intersect with any monitor.

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

Returns the bounding rectangle of the window in screen coordinates.

Errors

Returns Error::WindowsError if the window rectangle cannot be retrieved.

pub fn title_bar_height(&self) -> Result<u32, Error>

Calculates the height of the window’s title bar in pixels.

Errors

Returns Error if the title bar height cannot be determined.

pub fn is_valid(&self) -> bool

Checks if the window is a valid target for capture.

Returns

Returns true if the window is visible, not a tool window, and not a child window. Returns false otherwise.

pub fn enumerate() -> Result<Vec<Self>, Error>

Returns a list of all capturable windows.

Errors

Returns an Error if the window enumeration fails.

pub const fn from_raw_hwnd(hwnd: *mut c_void) -> Self

Creates a Window instance from a raw HWND handle.

Arguments

• hwnd - The raw HWND handle.

pub const fn as_raw_hwnd(&self) -> *mut c_void

Returns the raw HWND handle of the window.

Trait Implementations

impl Clone for Window

fn clone(&self) -> Window

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Window

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Window

fn eq(&self, other: &Window) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryIntoCaptureItemWithType for Window

fn try_into_capture_item( self, ) -> Result<(GraphicsCaptureItem, CaptureItemTypes), Error>

Attempts to convert the object into a GraphicsCaptureItem and its corresponding CaptureItemTypes variant.

impl Copy for Window

impl Eq for Window

impl Send for Window

impl StructuralPartialEq for Window