Modules/PSUtils/Functions/Set-Window.ps1
|
# =========================================================================== # Set-Window.ps1 ---------------------------------------------------------- # =========================================================================== # function ---------------------------------------------------------------- # --------------------------------------------------------------------------- Function Set-Window { <# .SYNOPSIS Retrieve/Set the window size and coordinates of a process window. .DESCRIPTION Retrieve/Set the size (height,width) and coordinates (x,y) of a process window. .PARAMETER ProcessName .PARAMETER Id .PARAMETER X .PARAMETER Y .PARAMETER Width .PARAMETER Height .PARAMETER Passthru .NOTES Name: Set-Window Author: Boe Prox Version History: 1.0//Boe Prox - 11/24/2015 - Initial build 1.1//JosefZ - 19.05.2018 - Treats more process instances of supplied process name properly 1.2//JosefZ - 21.02.2019 - Parameter Id Link: https://superuser.com/questions/1324007/setting-window-size-and-position-in-powershell-5-and-6 .OUTPUTS None System.Management.Automation.PSCustomObject System.Object .EXAMPLE Get-Process powershell | Set-Window -X 20 -Y 40 -Passthru -Verbose VERBOSE: powershell (Id=11140, Handle=132410) Id : 11140 ProcessName : powershell Size : 1134,781 TopLeft : 20,40 BottomRight : 1154,821 Description: Set the coordinates on the window for the process PowerShell.exe .EXAMPLE $windowArray = Set-Window -Passthru WARNING: cmd (1096) is minimized! Coordinates will not be accurate. PS C:\>$windowArray | Format-Table -AutoSize Id ProcessName Size TopLeft BottomRight -- ----------- ---- ------- ----------- 1096 cmd 199,34 -32000,-32000 -31801,-31966 4088 explorer 1280,50 0,974 1280,1024 6880 powershell 1280,974 0,0 1280,974 Description: Get the coordinates of all visible windows and save them into the $windowArray variable. Then, display them in a table view. .EXAMPLE Set-Window -Id $PID -Passthru | Format-Table Id ProcessName Size TopLeft BottomRight -- ----------- ---- ------- ----------- 7840 pwsh 1024,638 0,0 1024,638 Description: Display the coordinates of the window for the current PowerShell session in a table view. #> [CmdletBinding(PositionalBinding=$True, DefaultParameterSetName="Name")] Param ( [Parameter(Mandatory=$False, ValueFromPipelineByPropertyName=$True, ParameterSetName="Name", HelpMessage="Name of the process to determine the window characteristics. (All processes if omitted).")] [String]$ProcessName="*", [Parameter(Mandatory=$True, ValueFromPipeline=$False, ParameterSetName="Id", HelpMessage="Id of the process to determine the window characteristics. ")] [Int]$Id, [Parameter(HelpMessage="Set the position of the window in pixels from the left.")] [Int]$X, [Parameter(HelpMessage="Set the position of the window in pixels from the top.")] [Int]$Y, [Parameter(HelpMessage="Set the width of the window.")] [Int]$Width, [Parameter(HelpMessage="Set the height of the window.")] [Int]$Height, [Parameter(HelpMessage="Returns the output object of the window.")] [Switch]$Passthru ) Begin { Try { [Void][Window] } Catch { Add-Type @" using System; using System.Runtime.InteropServices; public class Window { [DllImport("user32.dll")] [return: MarshalAs(UnmanagedType.Bool)] public static extern bool GetWindowRect( IntPtr hWnd, out RECT lpRect); [DllImport("user32.dll")] [return: MarshalAs(UnmanagedType.Bool)] public extern static bool MoveWindow( IntPtr handle, int x, int y, int width, int height, bool redraw); [DllImport("user32.dll")] [return: MarshalAs(UnmanagedType.Bool)] public static extern bool ShowWindow( IntPtr handle, int state); } public struct RECT { public int Left; // x position of upper-left corner public int Top; // y position of upper-left corner public int Right; // x position of lower-right corner public int Bottom; // y position of lower-right corner } "@ } } Process { $Rectangle = New-Object RECT If ( $PSBoundParameters.ContainsKey('Id') ) { $Processes = Get-Process -Id $Id -ErrorAction SilentlyContinue } Else { $Processes = Get-Process -Name "$ProcessName" -ErrorAction SilentlyContinue } If ( $null -eq $Processes ) { If ( $PSBoundParameters['Passthru'] ) { Write-Warning 'No process match criteria specified' } } Else { $Processes | ForEach-Object { $Handle = $_.MainWindowHandle Write-Verbose "$($_.ProcessName) `(Id=$($_.Id), Handle=$Handle`)" If ( $Handle -eq [System.IntPtr]::Zero ) { Return } $Return = [Window]::GetWindowRect($Handle,[ref]$Rectangle) If (-NOT $PSBoundParameters.ContainsKey('X')) { $X = $Rectangle.Left } If (-NOT $PSBoundParameters.ContainsKey('Y')) { $Y = $Rectangle.Top } If (-NOT $PSBoundParameters.ContainsKey('Width')) { $Width = $Rectangle.Right - $Rectangle.Left } If (-NOT $PSBoundParameters.ContainsKey('Height')) { $Height = $Rectangle.Bottom - $Rectangle.Top } If ( $Return ) { $Return = [Window]::MoveWindow($Handle, $x, $y, $Width, $Height,$True) } If ( $PSBoundParameters['Passthru'] ) { $Rectangle = New-Object RECT $Return = [Window]::GetWindowRect($Handle,[ref]$Rectangle) If ( $Return ) { $Height = $Rectangle.Bottom - $Rectangle.Top $Width = $Rectangle.Right - $Rectangle.Left $Size = New-Object System.Management.Automation.Host.Size -ArgumentList $Width, $Height $TopLeft = New-Object System.Management.Automation.Host.Coordinates -ArgumentList $Rectangle.Left , $Rectangle.Top $BottomRight = New-Object System.Management.Automation.Host.Coordinates -ArgumentList $Rectangle.Right, $Rectangle.Bottom If ($Rectangle.Top -lt 0 -AND $Rectangle.Bottom -lt 0 -AND $Rectangle.Left -lt 0 -AND $Rectangle.Right -lt 0) { Write-Warning "$($_.ProcessName) `($($_.Id)`) is minimized! Coordinates will not be accurate." } $Object = [PSCustomObject]@{ Id = $_.Id ProcessName = $_.ProcessName Size = $Size TopLeft = $TopLeft BottomRight = $BottomRight } $Object } } } } } } |