AutoIt按名称移动桌面图标代码失效，求排查解决

原代码存在的核心问题 #

• 桌面控件获取错误：Win10及以上系统中，当启用壁纸幻灯片、深色模式等功能时，承载桌面图标的控件不在Progman窗口下，而是在WorkerW窗口的SysListView32控件里，原代码仅获取Progman的控件会导致无效句柄。
• 无错误校验逻辑：既没判断控件句柄是否获取成功，也没检查图标查找结果（_GUICtrlListView_FindInText找不到目标时返回-1，此时调用移动方法会完全无效）。
• 无限循环无意义：While 1无限重复移动图标，既浪费系统资源，也可能导致桌面控件异常，只需执行一次即可完成图标定位。
• 匹配逻辑模糊：_GUICtrlListView_FindInText默认是部分匹配，可能误匹配包含目标名称的其他图标。

修正后的代码 #

#AutoIt3Wrapper_UseX64=y
#include <GuiListView.au3>
#include <WindowsConstants.au3>

; 获取兼容Win10/11的桌面SysListView32控件句柄
Func _GetDesktopListViewHandle()
    Local $hProgman = WinGetHandle("[CLASS:Progman]")
    SendMessage($hProgman, 0x052C, 0, 0) ; 发送消息触发WorkerW窗口创建
    WinWait("[CLASS:WorkerW]")
    
    Local $hWorkerW = WinGetHandle("[CLASS:WorkerW]")
    Local $hListView = ControlGetHandle($hWorkerW, "", "[CLASS:SysListView32;INSTANCE:1]")
    
    ; 如果WorkerW下未找到控件，降级使用Progman的控件
    If Not $hListView Then
        $hListView = ControlGetHandle($hProgman, "", "[CLASS:SysListView32;INSTANCE:1]")
    EndIf
    Return $hListView
EndFunc

Func _SetShortcutPos($hListView, $Name = "", $X = 0, $Y = 0)
    If Not $hListView Then Return False
    ; 精确匹配图标文本（第三个参数2表示全字匹配）
    Local $iItemIndex = _GUICtrlListView_FindInText($hListView, $Name, 0, 2)
    If $iItemIndex = -1 Then
        ConsoleWrite("未找到目标图标：" & $Name & @CRLF)
        Return False
    EndIf
    _GUICtrlListView_SetItemPosition($hListView, $iItemIndex, $X, $Y)
    Return True
EndFunc

; 主执行逻辑
Local $hDesktopListView = _GetDesktopListViewHandle()
If Not $hDesktopListView Then
    ConsoleWrite("无法获取桌面控件句柄" & @CRLF)
    Exit
EndIf

_SetShortcutPos($hDesktopListView, "Tera Term", 100, 40)
_SetShortcutPos($hDesktopListView, "Help Desk", 200, 40)
_SetShortcutPos($hDesktopListView, "Visual Studio 2022", 300, 40)
_SetShortcutPos($hDesktopListView, "Plex", 400, 40)

关键修改说明 #

1. 兼容多系统桌面控件：通过发送系统消息触发WorkerW窗口创建，优先获取该窗口下的图标控件，同时保留Progman作为降级方案，覆盖Win10/11所有桌面状态。
2. 添加错误调试：通过ConsoleWrite输出错误信息，方便排查未找到图标、控件获取失败等问题。
3. 精确匹配图标名称：指定全字匹配规则，避免误操作相似名称的图标。
4. 移除无效循环：只执行一次图标移动操作，避免重复执行导致的系统异常。

内容的提问来源于stack exchange，提问作者Stammenator