C# SetWindowPos API 實戰：窗口置頂、位置大小控制完整指南

API 簽名與核心參數

[DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)]
private static extern bool SetWindowPos(
    IntPtr hWnd,           // 窗口句柄
    IntPtr hWndInsertAfter, // Z-order 參考窗口
    int X, int Y,          // 新位置
    int cx, int cy,        // 新尺寸
    uint uFlags            // 操作標誌位組合
);

關鍵常數定義

// hWndInsertAfter 特殊值
static readonly IntPtr HWND_TOP        = new IntPtr(0);      // 置頂
static readonly IntPtr HWND_BOTTOM     = new IntPtr(1);      // 置底
static readonly IntPtr HWND_TOPMOST    = new IntPtr(-1);     // 永久置頂
static readonly IntPtr HWND_NOTOPMOST  = new IntPtr(-2);     // 取消永久置頂

// uFlags 常用組合
const uint SWP_NOSIZE     = 0x0001; // 保持原尺寸
const uint SWP_NOMOVE     = 0x0002; // 保持原位置
const uint SWP_NOZORDER   = 0x0004; // 保持原 Z-order
const uint SWP_NOACTIVATE = 0x0010; // 不激活窗口
const uint SWP_SHOWWINDOW = 0x0040; // 顯示窗口

常用場景代碼模式

1. 窗口永久置頂（不改變位置大小）

// 在 Form_Load 中
SetWindowPos(this.Handle, HWND_TOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE);

2. 彈出新窗體並置頂

var frm = new Form2();
frm.Show();
// 獲取剛激活的前台窗口並置頂
SetWindowPos(GetForegroundWindow(), HWND_TOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE);

輔助 API：

[DllImport("user32.dll")]
private static extern IntPtr GetForegroundWindow();

3. 移動窗口到指定位置（保持大小、不改變 Z-order）

SetWindowPos(hWnd, IntPtr.Zero, 100, 100, 0, 0, SWP_NOSIZE | SWP_NOZORDER);

4. 調整窗口大小（保持位置、不改變 Z-order）

SetWindowPos(hWnd, IntPtr.Zero, 0, 0, 800, 600, SWP_NOMOVE | SWP_NOZORDER);

5. 取消置頂

SetWindowPos(hWnd, HWND_NOTOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE);

完整封裝工具類

public static class WindowPositionHelper {
    [DllImport("user32.dll", SetLastError = true)]
    private static extern bool SetWindowPos(IntPtr hWnd, IntPtr hWndInsertAfter, 
        int X, int Y, int cx, int cy, uint uFlags);
    
    [DllImport("user32.dll")]
    private static extern IntPtr GetForegroundWindow();
    
    private static readonly IntPtr HWND_TOPMOST = new IntPtr(-1);
    private static readonly IntPtr HWND_NOTOPMOST = new IntPtr(-2);
    private const uint SWP_NOSIZE = 0x0001;
    private const uint SWP_NOMOVE = 0x0002;
    private const uint SWP_NOZORDER = 0x0004;
    
    public static void SetTopMost(IntPtr hWnd, bool topMost) {
        SetWindowPos(hWnd, topMost ? HWND_TOPMOST : HWND_NOTOPMOST, 
            0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE);
    }
    
    public static void MoveWindow(IntPtr hWnd, int x, int y) {
        SetWindowPos(hWnd, IntPtr.Zero, x, y, 0, 0, SWP_NOSIZE | SWP_NOZORDER);
    }
    
    public static void ResizeWindow(IntPtr hWnd, int width, int height) {
        SetWindowPos(hWnd, IntPtr.Zero, 0, 0, width, height, SWP_NOMOVE | SWP_NOZORDER);
    }
    
    public static void SetBounds(IntPtr hWnd, int x, int y, int width, int height) {
        SetWindowPos(hWnd, IntPtr.Zero, x, y, width, height, SWP_NOZORDER);
    }
    
    public static void BringToFrontAndActivate(IntPtr hWnd) {
        SetWindowPos(hWnd, new IntPtr(0), 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE);
    }
}

避坑指南

WPF / WinForms 原生替代方案

• WinForms: Form.TopMost = true、Form.BringToFront()、Form.Location/Size
• WPF: Window.Topmost、Window.WindowStartupLocation、Window.Left/Top/Width/Height
• 僅在跨進程、無托管窗口句柄、或需精細控制 Z-order 時才直接呼叫 API