在 WinForms 應用中,有時需要讓特定控制項 (如圖表、影片播放器、編輯器) 佔滿整個螢幕,並提供 Esc 鍵退出全螢幕。本文提供兩種方案:WinAPI SetParent 法 (真正脫離父容器) 與 表單全螢幕法 (簡單易用)。
原理:呼叫 SetParent(hWndChild, IntPtr.Zero) 將控制項從原父視窗分離,掛載至桌面視窗,再設定尺寸為螢幕解析度。
using System;
using System.Runtime.InteropServices;
using System.Windows.Forms;
public static class FullScreenHelper
{
[DllImport("user32.dll", SetLastError = true)]
private static extern IntPtr SetParent(IntPtr hWndChild, IntPtr hWndNewParent);
[DllImport("user32.dll")]
private static extern bool GetClientRect(IntPtr hWnd, out RECT lpRect);
[StructLayout(LayoutKind.Sequential)]
private struct RECT { public int Left, Top, Right, Bottom; }
// 記錄原始父視窗與 Dock 樣式,供還原用
private static Control _targetControl;
private static IntPtr _originalParent;
private static DockStyle _originalDock;
///
/// 讓控制項進入全螢幕模式
///
public static void EnterFullScreen(Control control)
{
if (control == null) return;
_targetControl = control;
_originalParent = control.Parent.Handle;
_originalDock = control.Dock;
// 1. 解除 Dock,手動設定位置大小
control.Dock = DockStyle.None;
control.Left = 0;
control.Top = 0;
control.Width = Screen.PrimaryScreen.Bounds.Width;
control.Height = Screen.PrimaryScreen.WorkingArea.Height; // 扣除工作列
// 2. 重設父視窗為桌面 (IntPtr.Zero)
SetParent(control.Handle, IntPtr.Zero);
// 3. 註冊 ESC 鍵退出 (遞迴掛鉤子控制項)
HookEscapeKey(control);
}
///
/// 退出全螢幕,還原原狀
///
public static void ExitFullScreen()
{
if (_targetControl == null) return;
// 移除 ESC 事件 (略,實際需保存 delegate 參考)
// ...
// 還原父視窗與 Dock
SetParent(_targetControl.Handle, _originalParent);
_targetControl.Dock = _originalDock;
_targetControl = null;
_originalParent = IntPtr.Zero;
}
private static void HookEscapeKey(Control control)
{
control.KeyUp += Control_KeyUp;
foreach (Control child in control.Controls)
HookEscapeKey(child); // 子控制項也要接收按鍵
}
private static void Control_KeyUp(object sender, KeyEventArgs e)
{
if (e.KeyCode == Keys.Escape)
ExitFullScreen();
}
}
// 進入全螢幕 (按鈕點擊事件)
private void btnFullScreen_Click(object sender, EventArgs e)
{
FullScreenHelper.EnterFullScreen(this.chartControl1); // 任意控制項
}
// 也可在表單 KeyPreview=true 時統一處理 ESC
| 優點 | 缺點 |
|---|---|
| 控制項真正脫離原容器,不受父視窗裁切、Z-Order 影響 | 需 P/Invoke,跨平台 (Mono/.NET Core) 需另行處理 |
| 可針對單一控制項全螢幕 (非整個表單) | 需手動管理還原狀態 (父視窗、Dock、位置、大小) |
| 子控制項也能接收 ESC 鍵 | 若原父視窗為 MDI 子視窗,還原邏輯更複雜 |
若需求是「整個表單全螢幕」,直接操作 Form 屬性即可,無需 WinAPI。
public partial class FullScreenForm : Form
{
private FormWindowState _prevState;
private FormBorderStyle _prevBorder;
public FullScreenForm()
{
InitializeComponent();
this.KeyPreview = true; // 表單優先接收按鍵
this.KeyUp += FullScreenForm_KeyUp;
}
public void EnterFullScreen()
{
_prevState = this.WindowState;
_prevBorder = this.FormBorderStyle;
this.FormBorderStyle = FormBorderStyle.None;
this.WindowState = FormWindowState.Maximized;
// 或手動設定 Bounds = Screen.PrimaryScreen.Bounds;
}
public void ExitFullScreen()
{
this.FormBorderStyle = _prevBorder;
this.WindowState = _prevState;
}
private void FullScreenForm_KeyUp(object sender, KeyEventArgs e)
{
if (e.KeyCode == Keys.Escape)
ExitFullScreen();
}
}
// WPF 簡單全螢幕
var window = Window.GetWindow(myControl);
window.WindowStyle = WindowStyle.None;
window.WindowState = WindowState.Maximized;
window.ResizeMode = ResizeMode.NoResize;
// ESC 退出
window.KeyUp += (s, e) => { if (e.Key == Key.Escape) { window.WindowStyle = WindowStyle.SingleBorderWindow; window.WindowState = WindowState.Normal; window.ResizeMode = ResizeMode.CanResize; } };
根據專案實際需求選擇合適方案,並妥善處理狀態保存/還原、子控制項焦點、多螢幕環境等細節,即可實現專業級的全螢幕體驗。