Application.SetColorMode(SystemColorMode) 方法

定義

設定應用程式的預設色彩模式(暗黑模式)。

public:
 static void SetColorMode(System::Windows::Forms::SystemColorMode systemColorMode);
public static void SetColorMode(System.Windows.Forms.SystemColorMode systemColorMode);
[System.Diagnostics.CodeAnalysis.Experimental("WFO5001", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public static void SetColorMode(System.Windows.Forms.SystemColorMode systemColorMode);
static member SetColorMode : System.Windows.Forms.SystemColorMode -> unit
[<System.Diagnostics.CodeAnalysis.Experimental("WFO5001", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
static member SetColorMode : System.Windows.Forms.SystemColorMode -> unit
Public Shared Sub SetColorMode (systemColorMode As SystemColorMode)

參數

systemColorMode
SystemColorMode

應用程式預設的色彩模式(暗黑模式)要設定。

屬性

備註

你應該用這個方法來設定應用程式的預設色彩模式(暗黑模式)。 在建立任何 UI 元素前先設定,以確保使用正確的色彩模式。 你可以設定為暗黑模式(Dark)、光明模式(Classic)或系統設定(System)。

如果你設定成System,實際的色彩模式是由Windows系統設定決定的。 若系統設定被更改,應用程式將不會自動適應新設定。

請注意,深色模式僅在 Windows 11 或更新版本中提供。 若系統設定為高對比度模式,則無法開啟暗黑模式。

備註:Visual Basic: 如果你使用Visual Basic應用框架,應透過處理應用程式事件來設定色彩模式(參見 ApplyApplicationDefaults)。

適用於