在 Windows 桌面應用程式中,有時需程式化切換螢幕解析度 (如自動化測試、多媒體播放器)。VB.NET 可透過 P/Invoke 呼叫 Windows API ChangeDisplaySettings 達成。本文整理完整常數、結構與範例程式碼。
Imports System.Runtime.InteropServices
Public Class DisplaySettings
' API 宣告
<DllImport("user32.dll", CharSet:=CharSet.Ansi)>
Public Shared Function ChangeDisplaySettings(ByRef lpDevMode As DEVMODE, dwFlags As Integer) As Integer
End Function
<DllImport("gdi32.dll")>
Public Shared Function GetDeviceCaps(hdc As IntPtr, nIndex As Integer) As Integer
End Function
' 常數
Public Const CCDEVICENAME = 32
Public Const CCFORMNAME = 32
Public Const DM_BITSPERPEL = &H40000
Public Const DM_PELSWIDTH = &H80000
Public Const DM_PELSHEIGHT = &H100000
Public Const DM_DISPLAYFREQUENCY = &H400000
Public Const CDS_FORCE = &H80000000
Public Const BITSPIXEL = 12
Public Const HORZRES = 8
Public Const VERTRES = 10
Public Const VREFRESH = 116
' DEVMODE 結構 (對應 Win32 DEVMODE)
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Ansi)>
Public Structure DEVMODE
<MarshalAs(UnmanagedType.ByValTStr, SizeConst:=CCDEVICENAME)>
Public dmDeviceName As String
Public dmSpecVersion As Short
Public dmDriverVersion As Short
Public dmSize As Short
Public dmDriverExtra As Short
Public dmFields As Integer
Public dmOrientation As Short
Public dmPaperSize As Short
Public dmPaperLength As Short
Public dmPaperWidth As Short
Public dmScale As Short
Public dmCopies As Short
Public dmDefaultSource As Short
Public dmPrintQuality As Short
Public dmColor As Short
Public dmDuplex As Short
Public dmYResolution As Short
Public dmTTOption As Short
Public dmCollate As Short
<MarshalAs(UnmanagedType.ByValTStr, SizeConst:=CCFORMNAME)>
Public dmFormName As String
Public dmUnusedPadding As Short
Public dmBitsPerPel As Short
Public dmPelsWidth As Integer
Public dmPelsHeight As Integer
Public dmDisplayFlags As Integer
Public dmDisplayFrequency As Integer
End Structure
End Class
Private Sub btnChangeResolution_Click(sender As Object, e As EventArgs) Handles btnChangeResolution.Click
Dim dm As New DisplaySettings.DEVMODE()
dm.dmSize = CShort(Marshal.SizeOf(dm))
dm.dmFields = DisplaySettings.DM_PELSWIDTH Or DisplaySettings.DM_PELSHEIGHT Or DisplaySettings.DM_BITSPERPEL Or DisplaySettings.DM_DISPLAYFREQUENCY
dm.dmPelsWidth = 1920
dm.dmPelsHeight = 1080
dm.dmBitsPerPel = 32
dm.dmDisplayFrequency = 60
Dim ret As Integer = DisplaySettings.ChangeDisplaySettings(dm, DisplaySettings.CDS_FORCE)
If ret <> 0 Then
MessageBox.Show("變更失敗,不支援該模式。錯誤碼:" & ret)
Else
MessageBox.Show("變更成功!")
End If
End Sub
Private Sub Form_Load(sender As Object, e As EventArgs) Handles MyBase.Load
Dim hdc As IntPtr = Me.Handle ' 取得裝置內容
txtOldWidth.Text = DisplaySettings.GetDeviceCaps(hdc, DisplaySettings.HORZRES).ToString()
txtOldHeight.Text = DisplaySettings.GetDeviceCaps(hdc, DisplaySettings.VERTRES).ToString()
txtOldColor.Text = DisplaySettings.GetDeviceCaps(hdc, DisplaySettings.BITSPIXEL).ToString()
txtOldFreq.Text = DisplaySettings.GetDeviceCaps(hdc, DisplaySettings.VREFRESH).ToString()
End Sub
ChangeDisplaySettings 會失敗 (返回 DISP_CHANGE_FAILED = -1)。ChangeDisplaySettingsEx 指定裝置名稱。CDS_UPDATEREGISTRY (&H1) 旗標可寫入登錄,重開機後保持;否則僅暫時生效。P/Invoke 簽名相同,可直接用於 .NET 6/7/8 Windows Forms 或 WPF 專案,只需確保專案目標框架為 net6.0-windows 等 Windows 專用 TFM。