Downloads:
39
Downloads of v 1.0.0:
39
Last Update:
03 Jun 2023
Package Maintainer(s):
Software Author(s):
- foundata
Tags:
chocolatey-usewindow.extension focus window non-silent user32.dll- Software Specific:
- Software Site
- Software Source
- Software License
- Software Docs
- Software Issues
- Package Specific:
- Package Source
- Package outdated?
- Package broken?
- Contact Maintainers
- Contact Site Admins
- Software Vendor?
- Report Abuse
- Download
Chocolatey Use-Window extension (helper to focus a window)
- Software Specific:
- Software Site
- Software Source
- Software License
- Software Docs
- Software Issues
- Package Specific:
- Package Source
- Package outdated?
- Package broken?
- Contact Maintainers
- Contact Site Admins
- Software Vendor?
- Report Abuse
- Download
Downloads:
39
Downloads of v 1.0.0:
39
Maintainer(s):
Software Author(s):
- foundata
Chocolatey Use-Window extension (helper to focus a window)
Legal Disclaimer: Neither this package nor Chocolatey Software, Inc. are affiliated with or endorsed by foundata. The inclusion of foundata trademark(s), if any, upon this webpage is solely to identify foundata goods or services and not for commercial purposes.
- 1
- 2
- 3
All Checks are Passing
3 Passing Tests
This package was rejected on 19 Aug 2023. The reviewer TheCakeIsNaOH has listed the following reason(s):
A Chocolatey extension providing helper functions for querying and focusing windows. These functions may be used in Chocolatey install and uninstall scripts by declaring this package a dependency in your package's .nuspec
.
The most important function is Use-Window
, which is able to focus a window and bring it to the front. A script can easily switch between windows this way.
$ErrorActionPreference = 'Stop' # stop on all errors
$scriptRoot = Split-Path $MyInvocation.MyCommand.Definition
# get currently defined functions (before dot sourcing additional .ps1 files)
$functionsBefore = Get-ChildItem 'Function:\*'
# dot source files whose names start with a capital letter, ignore others
Get-ChildItem "${scriptRoot}\*.ps1" | Where-Object { $PSItem.Name -cmatch '^[A-Z]+' } | ForEach-Object { . $PSItem }
# get currently defined functions (after dot sourcing additional .ps1 files)
$functionsAfter = Get-ChildItem 'Function:\*'
# export functions whose names start with a capital letter, others are private
$functionsDiff = Compare-Object $functionsBefore $functionsAfter | Select-Object -ExpandProperty 'InputObject' | Select-Object -ExpandProperty 'Name'
$functionsDiff | Where-Object { $PSItem -cmatch '^[A-Z]+'} | ForEach-Object { Export-ModuleMember -Function $PSItem }
function Find-WindowHandle {
<#
.SYNOPSIS
Finds the handle of the window matching the given query. Returns an
IntPtr matching the given query if a window is found or IntPtr.Zero
otherwise.
.PARAMETER Query
A query that has one of the following formats:
- A RegEx pattern that is tested against all existing windows.
- A window handle.
- A window title followed by its handle enclosed in parentheses.
.EXAMPLE
Find the handle of the first window having "powershell" somewhere
in its name:
Find-WindowHandle 'powershell'
.EXAMPLE
Find the handle of the first window named exactly "powershell":
Find-WindowHandle '^powershell$'
.EXAMPLE
Return the given handle, if a window exists with this handle:
Find-WindowHandle 10101010
.EXAMPLE
Return the given handle, if a window exists with the handle at the
end of the given string:
Find-WindowHandle 'powershell (10101010)'
#>
Param(
[Parameter(Mandatory = $True,
HelpMessage = 'A RegEx pattern that is tested against all existing windows OR a window handle OR a window title followed by its handle enclosed in parentheses.')]
[String]$Query
)
# find handle in title (either the whole title is the handle, or enclosed in parenthesis)
if ($Query -match '^\d+$') {
$Handle = [IntPtr]::new($Query)
} elseif ($Query -match '^.+ \((\d+)\)\s*$') {
$Handle = [IntPtr]::new($Matches[1])
} else {
# find handle in existing processes.
$MatchingWindows = [UseWindowHelpers]::GetAllExistingWindows() | ? { $PSItem.Key -match $Query }
if (-not $MatchingWindows) {
return [IntPtr]::Zero
}
# no need to ensure the window does exist, return immediately
return $MatchingWindows[0].Value
}
# make sure the handle exists
if ([UseWindowHelpers]::WindowExists($Handle)) {
return $Handle
} else {
return [IntPtr]::Zero
}
}
Add-Type -Language 'CSharp' -ReferencedAssemblies @('System', 'System.Runtime.InteropServices') -TypeDefinition @"
using System;
using System.Collections.Generic;
using System.Runtime.InteropServices;
using System.Text;
public static class UseWindowHelpers
{
[DllImport("user32.dll")]
[return: MarshalAs(UnmanagedType.Bool)]
private static extern bool SetForegroundWindow(IntPtr hWnd);
[DllImport("user32.dll")]
[return: MarshalAs(UnmanagedType.Bool)]
private static extern bool ShowWindow(IntPtr hWnd, int nCmdShow);
public static void BringToFront(IntPtr handle)
{
ShowWindow(handle, 5);
SetForegroundWindow(handle);
}
[DllImport("user32.dll")]
[return: MarshalAs(UnmanagedType.Bool)]
private static extern bool GetWindowRect(IntPtr hWnd, out RECT lpRect);
[StructLayout(LayoutKind.Sequential)]
private struct RECT
{
public int Left, Top, Right, Bottom;
}
public static bool WindowExists(IntPtr handle)
{
RECT r;
return GetWindowRect(handle, out r);
}
private delegate bool EnumDesktopWindowsDelegate(IntPtr hWnd, int lParam);
[DllImport("user32.dll")]
private static extern bool EnumDesktopWindows(IntPtr hDesktop, EnumDesktopWindowsDelegate lpfn, IntPtr lParam);
[DllImport("user32.dll")]
private static extern int GetWindowText(IntPtr hWnd, StringBuilder lpWindowText, int nMaxCount);
public static List<KeyValuePair<string, IntPtr>> GetAllExistingWindows()
{
var windows = new List<KeyValuePair<string, IntPtr>>();
EnumDesktopWindows(IntPtr.Zero, (h, _) =>
{
StringBuilder title = new StringBuilder(256);
int titleLength = GetWindowText(h, title, 512);
if (titleLength > 0)
windows.Add(new KeyValuePair<string, IntPtr>(title.ToString(), h));
return true;
}, IntPtr.Zero);
return windows;
}
}
"@
function Use-Window {
<#
.SYNOPSIS
Focuses the window having the given handle and brings it to the front.
.PARAMETER Query
A window title query that will be resolved using "Find-WindowHandle".
.EXAMPLE
Focus the first window having "powershell" somewhere in its name and
bring it to the front:
Use-Window "powershell"
.EXAMPLE
Focus the first window named exactly "powershell" and bring it to the
front:
Use-Window'^powershell$'
#>
Param(
[Parameter(Mandatory = $True,
ValueFromPipeline = $True,
HelpMessage = 'A window title query that will be resolved using "Find-WindowHandle".')]
[ValidateScript({
if ( (Find-WindowHandle $PSItem) -eq 0 ) {
Throw "Use-Window: Cannot find window handle for query '${PSItem}'."
} else {
$True
}
})]
[String]$Query
)
$Handle = Find-WindowHandle $Query
[UseWindowHelpers]::BringToFront($Handle)
}
Log in or click on link to see number of positives.
In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).
Chocolatey Pro provides runtime protection from possible malware.
Copyright (c) 2018 Grégoire Geis (https://github.com/71/Focus-Window/) Copyright (c) 2022 Refactoring UI Inc. (https://github.com/tailwindlabs/heroicons/blob/master/optimized/24/outline/window.svg) Copyright (c) 2023 foundata GmbH (https://github.com/foundata/chocolatey-usewindow.extension)
This package has no dependencies.
Ground Rules:
- This discussion is only about Chocolatey Use-Window extension (helper to focus a window) and the Chocolatey Use-Window extension (helper to focus a window) package. If you have feedback for Chocolatey, please contact the Google Group.
- This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
- The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
- Tell us what you love about the package or Chocolatey Use-Window extension (helper to focus a window), or tell us what needs improvement.
- Share your experiences with the package, or extra configuration or gotchas that you've found.
- If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.
foundata (maintainer) on 03 Jun 2023 20:39:22 +00:00:
User 'foundata' (maintainer) submitted package.
chocolatey-ops (reviewer) on 03 Jun 2023 21:10:31 +00:00:
chocolatey-usewindow.extension has passed automated validation. It may have or may still fail other checks like testing (verification).
NOTE: No required changes that the validator checks have been flagged! It is appreciated if you fix other items, but only Requirements will hold up a package version from approval. A human review could still turn up issues a computer may not easily find.
Guidelines
Guidelines are strong suggestions that improve the quality of a package version. These are considered something to fix for next time to increase the quality of the package. Over time Guidelines can become Requirements. A package version can be approved without addressing Guideline comments but will reduce the quality of the package.
Notes
Notes typically flag things for both you and the reviewer to go over. Sometimes this is the use of things that may or may not be necessary given the constraints of what you are trying to do and/or are harder for automation to flag for other reasons. Items found in Notes might be Requirements depending on the context. A package version can be approved without addressing Note comments.
chocolatey-ops (reviewer) on 03 Jun 2023 21:14:58 +00:00:
chocolatey-usewindow.extension has passed automated package testing (verification). The next step in the process is package scanning.
Please visit https://gist.github.com/choco-bot/3e3dd7fa4ce018f5e105c4086c5158d9 for details.
This is an FYI only. There is no action you need to take.
chocolatey-ops (reviewer) on 03 Jun 2023 21:25:02 +00:00:
chocolatey-usewindow.extension has passed automated virus scanning.
foundata (maintainer) on 03 Jun 2023 21:48:41 +00:00:
If the review team is wondering what this is all about: We need to automate non-silent installers of old or niche software quite often. Depending on additional software like AutoHotKey (AHK) is not an option for us in these environments.
We therefore developed two lightweight extensions which are only using out-of-the-box PowerShell/.NET and thought this is might be useful for others, too. So we are able to interact with non-silent setup wizards easily by focusing their windows and sending keystrokes or mouse clicks:
chocolatey-usewindow.extension
exists for sharing the "find window, bring it to the front and focus it"-part as we split sending keystrokes and mouse clicks to keep it easy to use, modular and small.We understand a bit more of example code and documentation has to be added to make these extensions more useful for the community and someone who is searching for AHK alternatives. We already created issues for this and will provide better documentation soon:
Cheers,
Andreas
foundata (maintainer) on 03 Jun 2023 22:03:10 +00:00:
ProjectUrl
andProjectSourceUrl
are the same. It makes sense to send users to the repository, showing the renderedREADME.md
at this point in time, no matter if a user wants to know more about the package in general or to look at the source code.releaseNotes
will be filled out (pointing toCHANGELOG.md
) on the first update.TheCakeIsNaOH (reviewer) on 19 Aug 2023 16:24:29 +00:00:
Hi,
Community packages should not have "chocolatey" in their ID or title, see the naming conventions: https://docs.chocolatey.org/en-us/create/create-packages#naming-your-package
I'll reject this package as an invalid name, please resubmit under a different name.
Regards, TheCakeIsNaOH
Status Change - Changed status of package from 'submitted' to 'rejected'.
foundata (maintainer) on 19 Aug 2023 17:07:59 +00:00:
Hi TheCakeIsNaOH,
I don't know how we missed this rule (as we really read the linked page upfront). I can only guess there was some mental anchoring because of existing packages like chocolatey-fastanswers.extension.
Sorry for the circumstances. We will rename, test and resubmit.
Cheers,
Andreas
TheCakeIsNaOH (reviewer) on 19 Aug 2023 17:26:35 +00:00:
Sounds good.
There are quite a few packages grandfathered in using
chocolatey
in their ID, as they where created before that naming rule came into effect.Regards, TheCakeIsNaOH
foundata (maintainer) on 19 Aug 2023 23:58:23 +00:00:
Hi TheCakeIsNaOH,
I resubmitted the packages without the prefix:
Thanks again for explaining the issue, your time and efforts and sorry again for such an obvious, avoidable mistake on my side.
Cheers,
Andreas