AutoHotkey Chinese Documentation and Scripts

Many complex actions are implemented as external AutoHotkey scripts located in the 外部脚本 (External Scripts) directory.

Integration Details

• Parameters: External scripts support up to 3 command-line parameters.
• Variables: Scripts can utilize RuYi's built-in variables (e.g., %Windy_CurWin_FolderPath%).
• Example: The action 1037 (Run Selected Text) uses an external script to execute selected paths, URLs, or registry addresses.

Refer to scriptlist.md for a complete list of available external scripts.

The script implements two specialized context menu systems to provide advanced actions on selected items or active windows.

Candy Menu (Targeted at selected content)

Triggered for selected text, files, or folders. Features include:

• Quickly change drive letters for selected partitions.
• Move files to specific folders (e.g., moving audio files to a designated directory).
• View character encoding.
• Convert text file encoding.
• Text comparison (Note: large files may cause performance issues).

Windy Menu (Targeted at active windows)

Triggered for the current active window. Features include:

• Open the directory of the current window's process.
• Close all windows with the same name.
• Manage taskbar button grouping (via TTlib).
• Call specific VBA functions within WPS.

The script provides advanced mouse interaction capabilities.

Mouse Gestures (MG)

Triggered by holding the Right Mouse Button and moving the mouse. Actions can be customized to:

• Run functions.
• Send keystrokes.
• Execute preset actions (labels).

Enhanced Left Click

• Start Task Manager by clicking the bottom-right corner of the screen.
• Double-click a tab in Chrome to close it.
• Double-click empty space in WinRar to go up one level.

Enhanced Middle Click

• Close window via the title bar.
• Hide window icons on the desktop by clicking empty desktop space.
• Close windows via taskbar buttons.
• Exit programs via the system tray.

The underlying logic for these actions uses the VD.ahk library. The process involves:

1. Initializing the desktop environment via VD.init().
2. Ensuring at least 3 virtual desktops exist using VD.createUntil(3).
3. Moving the selected window (CandySel) to the target desktop number (CandySel2).
4. Jumping the view to that desktop number using VD.goToDesktopNum(CandySel2).

1459:
1460:
1461:
Gosub Candy
if !MyDesktop
{
	MyDesktop := VD.init()
	if VD.getCount() < 3
		VD.createUntil(3)
}
VD.MoveWindowToDesktopNum(CandySel, CandySel2)
VD.goToDesktopNum(CandySel2)
return

The RuYi-Ahk system provides a large set of built-in functions (prefixed with CF_) and commands (prefixed with Cando) that can be invoked using specific syntax. These functions support passing variables (e.g., %Windy_CurWin_id%).

There are two primary ways to invoke these:

1. canfunc: Used for functional commands, typically taking parameters.
2. Cando: Used for direct action commands, often without parameters.

Example syntax patterns:

• canfunc|CF_FunctionName|%Variable%
• Cando|ActionName

The Script Manager allows you to organize and run multiple scripts.

Behavior:

• All scripts located in the Script Manager folder will automatically start along with the main script.
• Exception: Any script filename starting with ! (e.g., !example.ahk) will not be automatically started.

The internal logic for action 1468 uses the VD.ahk library to manage virtual desktop state. The implementation follows these steps:

1. Checks if MyDesktop is initialized.
2. If not, calls VD.init() and ensures at least 3 desktops exist using VD.createUntil(3).
3. Uses VD.goToRelativeDesktopNum(+1) to perform the desktop switch.

Note: This action is part of a suite of virtual desktop management actions including 下一虚拟桌面 (Next Virtual Desktop, 1467) and various window/process management tools.

1468:
if !MyDesktop
{
	MyDesktop := VD.init()
	if VD.getCount() < 3
		VD.createUntil(3)
}
VD.goToRelativeDesktopNum(+1)
return

Introduced in 如意 (Ruyi) version 2.4, CombActions is a built-in action type that allows you to execute two actions sequentially. You define it by providing the two action IDs separated by a hyphen.

Syntax: CombActions|{ActionID1}-{ActionID2}

Example: To combine 'Lock Computer' (1519) and 'Turn off Monitor' (1168), use: CombActions|1519-1168

The 'Click Tray' action (Action ID: 1313) triggers the display of the RuYi panel by simulating a click on the RuYi tray icon. When executed, the current window is treated as the desktop, and the bottom panel is set to an unselected state. This action executes the built-in RuYi label TM_ShowMG.

Cando|TM_ShowMG