萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# 實現控制項全螢幕顯示與 ESC 退出完整代碼

在 WinForms 應用中,有時需要讓特定控制項 (如圖表、影片播放器、編輯器) 佔滿整個螢幕,並提供 Esc 鍵退出全螢幕。本文提供兩種方案:WinAPI SetParent 法 (真正脫離父容器) 與 表單全螢幕法 (簡單易用)。

方案一: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 子視窗,還原邏輯更複雜

方案二:表單全螢幕 — 簡單、純 managed、跨平台友好

若需求是「整個表單全螢幕」,直接操作 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 控制項全螢幕


// 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; } };

總結建議

  • 單一控制項全螢幕 (WinForms) → 方案一 (SetParent),功能最完整但複雜度最高。
  • 整個表單/視窗全螢幕 → 方案二 (Form 屬性),簡單、純 managed、易維護。
  • WPF / UWP / MAUI → 使用平台原生視窗狀態 API。
  • 跨平台 (.NET 6+) → 優先考慮方案二或平台原生 API,避免 P/Invoke 相容性問題。

根據專案實際需求選擇合適方案,並妥善處理狀態保存/還原、子控制項焦點、多螢幕環境等細節,即可實現專業級的全螢幕體驗。

copyright © 萬盛學電腦網 all rights reserved