| cycleWindow( | title, | | | | regExp | = | "(.*)", | | pathToRun | = | "" | ) |
|
Cycles through a subset of windows or launches a path.
Parameters
| title | The function searches for windows with this title. For example, you would put “Notepad” to find all notepad windows (as they contain “Notepad” in their title). Note that this doesn’t necessarily specify the window title per say. It could be something like “ahk_class CabinetWClass”. |
| regExp | A regular expression that describes how to display each window title in the listview (“title” not related to above parameter). The listview will display only the first group in the regular expression. Leaving it blank, or specifying “” will cause the window titles to be displayed as they are (“(.*)”). Specify “0” to not display the listview at all. This parameter is useful becaues you may not want to see the “ - Google Chrome” at the end of every Chrome window title. Specifying “(.*) - Google Chrome” here will trim that out. For more info on regular expressions, see http://www.autohotkey.com/docs/misc/RegEx-QuickRef.htm. |
| pathToRun | The path used to open a new window if necessary. |
SETTINGS
A few easily-changeable tweaks that affect how the function acts.
These can be found in the beginning lines of the function in cycleWindow.ahk. If you want these settings to differ between various calls of cycleWindow, you can add them as optional parameters to cycleWindow.
| cycleWindow_UseThumbnails | If you have Windows Vista or later, you can use window thumbnails. This is a nice way to show a window without having to actually activate it. This is the preferred way, but you will need to download maul.esel’s library from http://www.autohotkey.com/forum/viewtopic.php?t=70839, and uncomment the “#Include Thumbnail lib.ahk” statement at the top of cycleWindow.ahk |
| cycleWindow_thumbnailColor | Thumbnails are displayed on a GUI. This GUI, which is underneath the thumbnails, can be transparent or opaque. If you are using Aero (so the borders of your windows are transparent), having a colored GUI behind the thumbnails creates a nice highlighting effect. Specify the color of the highlight in this setting. To disable highlight, set it to “0” (this might be desirable if you don’t use aero transparency). |
| cycleWindow_thumbnailBorder | Thumbnails are displayed on a GUI. This displays how many pixels the GUI should extend out from behind the thumbnail, to create a border. If you are using Aero, the highlighting effect should be enough, so set this to 0. |
| cycleWindow_disableThumbFade | Disables the highlight-fading that occurs when your release your finger from the holdkey (e.g. CapsLock). This feature uses the only global variable in cycleWindow. |
| cycleWindow_ListViewGUI | The GUI number (1-99) that will be used to create the ListView which shows the window titles. |
| cycleWindow_ThumbnailGUI | The GUI number (1-99) that will be used to create the windows’ thumbnails (if cycleWindow_UseThumbnails is set to true). |
| cycleWindow_matchMode | TitleMatchMode. Used with AHK’s SetTitleMatchMode (http://www.autohotkey.com/docs/commands/SetTitleMatchMode.htm) to set how windows are to be searched with the title parameter. It has been set to 2, meaning that if a window contains title’s text anywhere in its title, it is considered a match. |
| cycleWindow_ListViewWidth | The width (in pixels) of the ListView. Increasing the width will cause the ListView to extend farther into the center of the screen. This is set initially to 150. |
| cycleWindow_NewWindowKey | If this key is held down when you press the cycle key, the function launches a new window by running the path of the parameter pathToRun. It is set initially to “LWin”. |