الوضع الداكن وسمة التباين في تطبيقات Windows ── شريط العنوان الداكن عبر DWM، وتتبع سمة النظام في WinForms/WPF، والرسم عند التباين العالي

«استبدلنا حواسيب الشركة بـ Windows 11 فجاء موظّفون على الوضع الداكن يقولون: تطبيق الأعمال عندنا وحده شريط عنوانه أبيض ناصع يؤذي العين»، «فعّل موظّف ضعيف البصر سمة التباين فاختفى عرض الحالة في شاشة الطلبات» ── عرضان ازدادت الاستشارة حولهما في السنة أو السنتين الأخيرتين.

الأوّل من إعداد «الألوان» في Windows 11، والثاني من إعداد «إمكانية الوصول»، لكن عين المطوّر تراهما المشكلة نفسها: «لا يتبع السمة». وفي الواقع أساس المعالجة مشترك. لا تثبّت الألوان برمجيّاً؛ اقرأ إعداد النظام، ولاحظ التغيير، وأعد الطلاء. هذه ثلاث نقاط.

المقالة السابقة «مدخل إلى إمكان الوصول في تطبيقات Windows» تناولت الآلية التي تقرأ بها قارئات الشاشة (UI Automation) وأساسيات التسمية ولوحة المفاتيح واللون. لمست فيها تتبع سمة التباين، لكنّها لم تتناول وضع اللون الفاتح/الداكن نفسه. هذه المقالة أختها، وتربط محورين: وضع اللون (فاتح/داكن) وسمة التباين، على مستوى التنفيذ، بهذا الترتيب: رسم شريط العنوان عبر DWM (مدير نوافذ سطح المكتب)، وتتبع سمة النظام في WinForms/WPF، والرسم تحت سمة التباين. القرّاء المستهدفون مطوّرون يطوّرون ويصونون تطبيقات أعمال بـ WinForms/WPF/Win32، البيئة المفترضة Windows 11 (شريط العنوان الداكن من الإصدار 22000 فما بعده) وWinForms وWPF على .NET 9/10 (على .NET Framework 4.8 و.NET 8 يُنفَّذ بعضه يدوياً)، الصعوبة متوسّطة.

flowchart TB
    accTitle: مسار هذه المقالة
    accDescr: من ترتيب محوري السمة، إلى سبب البقاء فاتحاً افتراضيّاً، فشريط العنوان الداكن عبر DWM، فآلية الكشف والتتبع، فتنفيذ WinForms وWPF، فالرسم تحت سمة التباين، فاختيار السياسة والتحقّق، بهذا الترتيب
    axes["ترتيب محوري السمة"] --> why["سبب البقاء فاتحاً افتراضيّاً"]
    why --> dwm["شريط العنوان الداكن عبر DWM"]
    dwm --> detect["آلية الكشف والتتبع"]
    detect --> impl["تنفيذ WinForms/WPF"]
    impl --> hc["الرسم تحت سمة التباين"]
    hc --> policy["اختيار السياسة والتحقّق"]

الشكل 1: تربط هذه المقالة ترتيب السمة بالآلية والتنفيذ وسمة التباين والتحقّق في مسار واحد.

1. الخلاصة أوّلاً

• «سمة» Windows محوران. الفاتح/الداكن (وضع اللون) تحت «الإعدادات > التخصيص > الألوان»، و«الإعدادات > إمكانية الوصول > سمات التباين». الثانية لوحة مقيَّدة بنسبة تباين تبلغ تقريباً 7:1 فما فوق، وهي غير الفاتح/الداكن. ما دامت سمة التباين مفعّلة لا يتاح الوضع الداكن. أولوية الحكم «سمة التباين ← الفاتح/الداكن».¹²
• بقاء شريط عنوان التطبيق القائم أبيض افتراض للتوافق. Windows لا يملك وسيلة لمعرفة هل التطبيق يدعم الداكن، فيعامل كلّ النوافذ فاتحة افتراضيّاً.³
• تغميق شريط العنوان هو DWMWA_USE_IMMERSIVE_DARK_MODE (القيمة 20) لـ DwmSetWindowAttribute. تمرير TRUE من BOOL يرسم الإطار داكناً عندما يكون النظام داكناً. الدعم الموثَّق Windows 11 الإصدار 22000 فما بعده.⁴³
• الوضع الحالي يُقرأ بـ UISettings.GetColorValue، والتغيير يُستقبل بـ ColorValuesChanged. حكم Microsoft الرسمي: إن كان لون المقدّمة (لون النصّ الافتراضي) ساطعاً فالوضع داكن. لا ضمان لوصول الحدث على خيط الواجهة، فارجع إلى الواجهة ثمّ أعد الطلاء.³⁵
• في WinForms دخل Application.SetColorMode في .NET 9 ولم يعد تجريبيّاً في .NET 10. استدعِ SystemColorMode.System قبل Application.Run. القيود الثلاثة: Windows 11 فقط، معطّل أثناء سمة تباين، لا يتبع تغيّر الإعداد أثناء التشغيل.⁶⁷²
• في WPF دخلت سمة Fluent وThemeMode في .NET 9. يتبع بـ ThemeMode="System" ويُتحكَّم أيضاً في تغميق النافذة. لكن التشغيل من الشيفرة تجريبي حتّى في .NET 10 (WPF0001)، ونمط Fluent «قيد العمل». إن بقيت على السمة التقليدية فبدّل ResourceDictionary للفاتح/الداكن بـ DynamicResource.⁸⁹¹⁰
• تحت سمة التباين انقل الألوان إلى أزواج ألوان النظام الصحيحة، واحذف الصور خلف النصّ، وارسم الرسوم متعدّدة الألوان بلوني المقدّمة والخلفية. الحكم بـ SPI_GETHIGHCONTRAST (في WinForms SystemInformation.HighContrast، وفي WPF SystemParameters.HighContrast)، والإشعار بـ WM_SYSCOLORCHANGE / WM_THEMECHANGED (في .NET SystemEvents.UserPreferenceChanged).¹¹¹²¹³
• دعم الوضع الداكن ليس بديلاً عن دعم إمكانية الوصول. لوحة الداكن أيضاً تحتاج نسبة تباين 4.5:1، والإبلاغ الذي لا يعتمد على اللون وحده لازم في أيّ سمة.¹⁴¹⁵

إن لخّصنا جملة: دعم السمة هو «جمع الألوان في موضع واحد، وقراءة إعداد النظام، وملاحظة التغيير وإعادة الطلاء. لكن تحت سمة التباين أوكل جملة إلى أزواج ألوان النظام».

في المخطّط، يشير الخطّ المتّصل إلى علاقة قائمة دائماً، ويشير الخطّ المتقطّع إلى علاقة مشروطة (شروط قيامها مذكورة في شرح كلّ علاقة في الصفحة التفصيليّة). القائمة الكاملة للعلاقات (المجموع 28، مع الأدلّة ودرجة اليقين) وتعريفات المفاهيم الرئيسة مجمّعة في صفحة تفاصيل خريطة المعرفة (باليابانية). البيانات: JSON-LD / Turtle

2. «السمة» محوران ── الفاتح/الداكن وسمة التباين

2.1. الفاتح/الداكن (وضع اللون)

وضع اللون في «الإعدادات > التخصيص > الألوان» في Windows إعداد يحدّد سطوع لون المقدّمة ولون الخلفية لنظام التشغيل والتطبيق جملة. تعرّف وثائق Microsoft الفاتح بأنّه «خلفية ساطعة ومقدّمة داكنة»، والداكن بأنّه «خلفية داكنة ومقدّمة ساطعة»، وتضيف أن المقدّمة هنا «لون النصّ الافتراضي». في الوضع الداكن تصير المقدّمة (النصّ) ساطعة والخلفية داكنة.³

يُحفظ هذا الإعداد في قيمتي DWORD AppsUseLightTheme (وضع التطبيق) وSystemUsesLightTheme (وضع Windows نفسه) تحت HKCU\Software\Microsoft\Windows\CurrentVersion\Themes\Personalize في السجلّ، وهما في مرجع إعدادات Microsoft.¹⁶ لكن كما سيأتي، المسار النظامي للقراءة من التطبيق هو UISettings في WinRT.

2.2. سمة التباين (التباين العالي)

سمة التباين المختارة تحت «الإعدادات > إمكانية الوصول > سمات التباين» تستخدم لوحة مقيَّدة لتبلغ نسبة تباين تقريباً 7:1 فما فوق، وهي لمن يحتاجون فصلاً بصريّاً قويّاً بين المقدّمة والخلفية. في Windows 11 أربعة أنواع مضمَّنة: Aquatic وDesert وDusk وNight sky، ويمكن للمستخدم لا الاختيار منها فقط بل تحرير ألوان الخلفية والنصّ والارتباط التشعّبي والنصّ المعطّل ونصّ التحديد والزرّ فرادى. يمكن التبديل سريعاً بـ Left Alt+Left Shift+PrintScreen، وإن لم يُختر شيء طُبِّق Aquatic.¹

تنصّ وثائق Microsoft صراحة: «لا تخلط سمات التباين بسمات الفاتح/الداكن». الفاتح/الداكن يستخدم لوحة واسعة وليس محسَّناً لأقصى تباين.¹ والمهمّ أن الوضع الداكن لا يتاح أثناء تفعيل سمة تباين. لا يقدّم Application.SetColorMode في WinForms الداكن أثناء سمة تباين، وRequestedTheme في XAML يتجاوزه النظام.²¹⁷

2.3. أولوية الحكم

إذن تنفيذ التطبيق بهذا الترتيب. احكم أوّلاً هل سمة التباين مفعّلة، فإن كانت فأوكل جملة إلى ألوان النظام. وإن لم تكن فاختر لوحة الفاتح أو الداكن.

flowchart TB
    accTitle: محورا السمة وأولوية الحكم
    accDescr: إن كانت سمة التباين مفعّلة فأوكل جملة إلى أزواج ألوان النظام، وإن لم تكن فاقرأ وضع اللون الفاتح/الداكن واختر لوحة التطبيق
    q1{"هل سمة التباين مفعّلة؟"}
    q1 -->|مفعّلة| sys["أوكل إلى أزواج ألوان النظام"]
    q1 -->|غير مفعّلة| q2{"وضع اللون هو؟"}
    q2 -->|فاتح| light["لوحة الفاتح"]
    q2 -->|داكن| dark["لوحة الداكن"]
    sys -.-> note["الوضع الداكن غير متاح"]

الشكل 2: ضع حكم سمة التباين أوّلاً، ولا تختر لوحة الفاتح/الداكن إلّا عندما تكون غير مفعّلة.

3. لماذا تبقى التطبيقات القائمة بيضاء في الوضع الداكن

النافذة من منطقتين. منطقة غير العميل من شريط العنوان والإطار وأزرار التعليق، ومنطقة العميل التي يرسمها التطبيق. من Windows Vista فما بعده يركّب DWM (مدير نوافذ سطح المكتب) منطقة غير العميل ويرسمها، ويحدّد التطبيق سمات الرسم بـ DwmSetWindowAttribute.¹⁸

تشرح وثائق Microsoft سبب بقاء التطبيقات القائمة بيضاء بصراحة. «Windows لا يعرف هل يستطيع التطبيق دعم الوضع الداكن، فيفترض للتوافق العكسي أنّه لا يستطيع». هناك أطر تعامل الوضع الداكن أصلاً مثل WinUI وWindows App SDK، لكن تطبيقات Win32 في كثير من الحالات لا تدعم الوضع الداكن، فيعطي Windows افتراضيّاً شريط عنوان فاتحاً.³

flowchart TB
    accTitle: منطقتا النافذة وجهة الرسم
    accDescr: منطقة غير العميل من شريط العنوان والإطار يرسمها DWM، ومنطقة العميل يرسمها التطبيق أو إطار الواجهة، فدعم الداكن يلزم لكليهما
    win["نافذة المستوى الأعلى"] --> nc["منطقة غير العميل (شريط العنوان والإطار)"]
    win --> client["منطقة العميل (محتوى الشاشة)"]
    nc --> dwm["يركّبها DWM ويرسمها"]
    client --> app["يرسمها التطبيق أو الإطار"]
    dwm -.-> attr["يُشار إليها بـ DwmSetWindowAttribute"]
    app -.-> palette["لوحة التطبيق نفسه"]

الشكل 3: شريط العنوان يرسمه DWM والمحتوى يرسمه التطبيق، فدعم الداكن يحتاج إشارة إلى DWM ولوحة التطبيق كليهما.

من هنا نتيجتان. الأولى أن تغميق شريط العنوان يحتاج أن يطلب التطبيق من DWM صراحة. والثانية أن ما يصير داكناً نتيجة الطلب شريط العنوان فقط، ومنطقة العميل يجب أن يعيد التطبيق طلاءها بنفسه. تقول الوثائق أيضاً «لدعم الوضع الداكن كاملاً يلزم أن يتبع سطح التطبيق كلّه السمة الداكنة»، وتقطع بأن الدليل الرسمي يعالج الكشف وشريط العنوان حتّى، ولا يعالج طريقة إعادة طلاء منطقة العميل.³ تطبيق شريط عنوانه أسود ومحتواه أبيض أشدّ نشازاً من تطبيق أبيض كما هو.

flowchart TB
    accTitle: آلية البقاء فاتحاً افتراضيّاً
    accDescr: Windows لا يعرف هل التطبيق يدعم الداكن فيجعله فاتحاً افتراضيّاً للتوافق، ولا يرسم الإطار وفق إعداد النظام الداكن إلّا عندما يمرّر التطبيق TRUE لسمة DWM
    unknown["Windows لا يعرف إمكان الدعم"] --> def["الافتراض فاتح للتوافق"]
    def --> q{"هل مرّر التطبيق TRUE؟"}
    q -->|لا| light["إطار فاتح دائماً"]
    q -->|نعم| follow["يُرسم وفق إعداد النظام"]

الشكل 4: Windows الذي لا يعرف إمكان الدعم يجعله فاتحاً افتراضيّاً، ولا يتبع إلّا عند إشارة صريحة من التطبيق.

4. شريط العنوان الداكن عبر DWM ── DwmSetWindowAttribute

4.1. DWMWA_USE_IMMERSIVE_DARK_MODE

سمة تغميق شريط العنوان هي DWMWA_USE_IMMERSIVE_DARK_MODE. شرح تعداد DWMWINDOWATTRIBUTE هكذا. «السماح برسم إطار هذه النافذة بألوان الوضع الداكن عندما يكون إعداد النظام للوضع الداكن مفعّلاً. للتوافق تصير كلّ النوافذ وضعاً فاتحاً افتراضيّاً بغضّ النظر عن إعداد النظام. يشير pvAttribute إلى BOOL، فـ TRUE يحترم الوضع الداكن وFALSE يظلّ فاتحاً دائماً. مدعوم في Windows 11 الإصدار 22000 فما بعده».⁴

أي أن TRUE ليس «اجعله داكناً» بل إذن «إن كان النظام داكناً جاز جعله داكناً». إن كان جانب التطبيق جاهزاً لطلاء منطقة العميل داكنة، فتمرير TRUE وحده يجعل شريط العنوان يتبع إعداد النظام. وبالعكس، إن كان التصميم عرضاً فاتحاً دائماً («تثبيت الفاتح» الآتي) فلا بأس بالإبقاء على FALSE الافتراضي.

شيفرة C++ في الدليل الرسمي بهذا الشكل. تشمل حتّى إجراء تعريف القيمة 20 ذاتيّاً لأن الثابت قد لا يوجد في ترويسة SDK قديمة.³

#include <dwmapi.h>
#pragma comment(lib, "dwmapi.lib")

#ifndef DWMWA_USE_IMMERSIVE_DARK_MODE
#define DWMWA_USE_IMMERSIVE_DARK_MODE 20
#endif

// هل هو Windows 11 (الإصدار 22000) فما بعده. يفترض بياناً
// supportedOS لـ Windows 10 فما بعده (وإلّا يُدوَّر الإصدار إلى ما يعادل Windows 8)
bool IsWindows11OrGreater()
{
    OSVERSIONINFOEXW osvi{ sizeof(osvi) };
    osvi.dwMajorVersion = 10;
    osvi.dwMinorVersion = 0;
    osvi.dwBuildNumber = 22000;
    DWORDLONG mask = 0;
    VER_SET_CONDITION(mask, VER_MAJORVERSION, VER_GREATER_EQUAL);
    VER_SET_CONDITION(mask, VER_MINORVERSION, VER_GREATER_EQUAL);
    VER_SET_CONDITION(mask, VER_BUILDNUMBER, VER_GREATER_EQUAL);
    return ::VerifyVersionInfoW(
        &osvi, VER_MAJORVERSION | VER_MINORVERSION | VER_BUILDNUMBER, mask) != FALSE;
}

// honorDarkMode = true: إن كان النظام داكناً جاز رسم شريط العنوان داكناً أيضاً
void ApplyTitleBarTheme(HWND hwnd, bool honorDarkMode)
{
    if (!IsWindows11OrGreater())
    {
        // الدعم الموثَّق من الإصدار 22000 فما بعده. دون ذلك لا تُستدعَ واتبع الافتراض (فاتح)
        LogInfo(L"DWMWA_USE_IMMERSIVE_DARK_MODE is not documented for this OS build; keeping the default light frame");
        return;
    }
    BOOL value = honorDarkMode ? TRUE : FALSE;
    HRESULT hr = ::DwmSetWindowAttribute(
        hwnd, DWMWA_USE_IMMERSIVE_DARK_MODE, &value, sizeof(value));
    if (FAILED(hr))
    {
        // الفشل على نظام تشغيل مدعوم شذوذ. لا تبتلعه صامتاً؛ سجّل HRESULT وأظهره
        LogWarning(L"DwmSetWindowAttribute(DWMWA_USE_IMMERSIVE_DARK_MODE) failed: 0x%08X", hr);
    }
}

نضيف جملة عن سبب التقسيم بإصدار نظام التشغيل. الدعم الموثَّق Windows 11 الإصدار 22000 فما بعده.⁴ التقارير بأن القيمة نفسها تنفع في Windows 10 ليست نادرة، لكن لا ينبغي لتطبيق أعمال أن يعتمد عرضه على سلوك غير موثَّق. إن صمّمت «جرّب الاستدعاء وإن فشل فاتركه» نجح الاستدعاء في Windows 10 فصار شريط العنوان داكناً فوق سلوك غير موثَّق. دون الإصدار 22000 لا تُستدعَ واتبع الافتراض الموثَّق «شريط عنوان فاتح»، وعلى نظام تشغيل مدعوم سجّل HRESULT عند الفشل وأظهره، هذا فقط. إجراءات قديمة تستخدم القيمة 19، أو تستدعي تصدير ترتيب uxtheme.dll لتغميق التحكّمات المشتركة، شائعة على الإنترنت أيضاً، وكلّها واجهات غير عامّة ولا يضمن أحد تغيّر السلوك عند التحديث.

4.2. توقيت الاستدعاء ── عندما يكون HWND حيّاً، وكلّما أُعيد إنشاؤه

DwmSetWindowAttribute يُستدعى على HWND، فيجب أن يكون بعد إنشاء مقبض النافذة. ونموذج WinForms قد يُعاد إنشاء المقبض عند تغيّر ShowInTaskbar ونحوه. المقبض الجديد بعد إعادة الإنشاء لا يحمل السمة، فموضع الاستدعاء ليس «المنشئ» بل «موضع يُستدعى كلّما أُنشئ المقبض». في WinForms OnHandleCreated، وفي WPF SourceInitialized.

flowchart TB
    accTitle: توقيت استدعاء DwmSetWindowAttribute
    accDescr: اضبط سمة DWM بعد إنشاء مقبض النافذة، وأعد الضبط على المقبض الجديد إن أُعيد إنشاء المقبض، وأعد الضبط أيضاً عند إشعار تغيّر السمة
    create["إنشاء HWND"] --> apply["ضبط سمة DWM"]
    apply --> run["أثناء العرض"]
    run -->|إعادة إنشاء المقبض| create
    run -->|إشعار تغيّر السمة| apply

الشكل 5: سمة DWM مربوطة بـ HWND، فأعد ضبطها عند كلّ إنشاء وكلّ إعادة إنشاء.

P/Invoke في WinForms كما يلي (لكتابة DllImport الآمنة راجع «استدعاء Win32 API بأمان من C#»).

using System.Runtime.InteropServices;

public partial class MainForm : Form
{
    private const int DWMWA_USE_IMMERSIVE_DARK_MODE = 20;

    [DllImport("dwmapi.dll")]
    private static extern int DwmSetWindowAttribute(
        IntPtr hwnd, int attribute, ref int value, int size);

    protected override void OnHandleCreated(EventArgs e)
    {
        base.OnHandleCreated(e);
        ApplyTitleBarTheme();
    }

    private void ApplyTitleBarTheme()
    {
        // الدعم الموثَّق من الإصدار 22000 فما بعده. دون ذلك لا تُستدعَ واتبع الافتراض (فاتح).
        // حكم يعمل أيضاً على .NET Framework. لكن على .NET Framework، إن لم يوجد بيان
        // supportedOS لـ Windows 10 فما بعده دُوِّر الإصدار إلى ما يعادل Windows 8
        // (على .NET 5 فما بعده يجوز OperatingSystem.IsWindowsVersionAtLeast(10, 0, 22000))
        if (Environment.OSVersion.Version < new Version(10, 0, 22000))
        {
            _logger.LogInformation("Dark title bar is not documented for this OS build; keeping the default light frame");
            return;
        }
        // 1(TRUE) = إن كان النظام داكناً جاز الرسم داكناً. 0(FALSE) = فاتح دائماً
        int honorDarkMode = 1;
        int hr = DwmSetWindowAttribute(
            Handle, DWMWA_USE_IMMERSIVE_DARK_MODE, ref honorDarkMode, sizeof(int));
        if (hr < 0)
        {
            _logger.LogWarning("DwmSetWindowAttribute failed: 0x{Hr:X8}", hr);
        }
    }
}

هذه الشيفرة لازمة لتطبيقات .NET 8 فما قبله و.NET Framework وWin32/MFC. إن استخدمت Application.SetColorMode في WinForms على .NET 9 فما بعده، أو ThemeMode في WPF على .NET 9 فما بعده، يتولّى الإطار تغميق النافذة (وثائق ThemeMode تنصّ على أنّه «يتحكّم أيضاً في تطبيق مادّة الخلفية والوضع الداكن على النافذة»).¹⁰ الاستدعاء المزدوج لا يضرّ، لكن مصدر المسؤولية يلتبس فاختر أحدهما.

في WPF يتحدّد HWND عند SourceInitialized. خذ المقبض من WindowInteropHelper.¹⁹

using System.Windows.Interop;

public partial class MainWindow : Window
{
    protected override void OnSourceInitialized(EventArgs e)
    {
        base.OnSourceInitialized(e);
        var hwnd = new WindowInteropHelper(this).Handle;
        TitleBarTheme.Apply(hwnd, honorDarkMode: true); // المحتوى P/Invoke السابق
    }
}

4.3. لون شريط العنوان ولون النصّ ولون الإطار ومادّة الخلفية

في Windows 11 أُضيفت أيضاً سمات تحدّد لون شريط العنوان نفسه، لا خيار الداكن/الفاتح وحده.

السمات الثلاث التي تحدّد لوناً تعود إلى افتراض النظام عند تمرير DWMWA_COLOR_DEFAULT (0xFFFFFFFF). للون الإطار انتبه إلى أن «تغيير اللون وفق تغيّر الحالة مثل تنشيط النافذة مسؤولية التطبيق».⁴ مادّة الخلفية تُحدَّد بتعداد DWM_SYSTEMBACKDROP_TYPE، وDWMSBT_MAINWINDOW يعادل Mica في Windows 11 وDWMSBT_TRANSIENTWINDOW يعادل Acrylic، لكنّه منصوص أن «أثر المادّة قد يتغيّر في Windows لاحق».²⁰

موضع الاستخدام في تطبيق أعمال فكّر فيه بحذر. طلاء شريط العنوان بلون العلامة يولّد مسؤولية ضمان تباين نصّ العنوان وأزرار التعليق فوق ذلك اللون بنفسك. إلى حالتي الداكن/الفاتح تُضاف توليفة نشط/غير نشط. الصواب لكثير من تطبيقات الأعمال «اتبع افتراض النظام (TRUE للقيمة 20 فقط)»، ولون العلامة خيار عندما يلزم حقّاً.

flowchart TB
    accTitle: كيف تقرّر لون شريط العنوان
    accDescr: إن اتبعت افتراض النظام كفت TRUE للقيمة 20، وإن طليت بلون العلامة صارت مسؤولية ضمان تباين النصّ وأزرار التعليق وإدارة لون النشط/غير النشط على التطبيق، وللإرجاع مرّر DWMWA_COLOR_DEFAULT
    q{"لون شريط العنوان هو؟"}
    q -->|اتبع افتراض النظام| dark["TRUE للقيمة 20 فقط"]
    q -->|اطلِ بلون العلامة| brand["حدّد سمات اللون (34–36)"]
    brand --> resp["اضمن بنفسك تباين النصّ والأزرار"]
    brand --> states["أدر بنفسك النشط/غير النشط"]
    brand -.-> reset["للإرجاع COLOR_DEFAULT"]

الشكل 6: اختيار لون العلامة ينقل مسؤولية التباين وإدارة الحالة إلى جهة التطبيق، وفي كثير من تطبيقات الأعمال الصواب اتباع الافتراض.

5. كشف سمة النظام وتتبعها ── اقرأ ولاحظ وأعد الطلاء

عمل جعل منطقة العميل تتبع ينقسم ثلاثة. اقرأ الإعداد الحالي، لاحظ التغيير، ثمّ أعد الطلاء.

flowchart TB
    accTitle: ثلاث خطوات للكشف والتتبع
    accDescr: حلقة تقرأ وضع اللون الحالي بـ UISettings عند التشغيل، وتلاحظ التغيير بإشعارات مثل ColorValuesChanged، وترجع إلى خيط الواجهة وتعيد تطبيق لوحة التطبيق
    read["اقرأ: UISettings.GetColorValue"] --> paint["أعد الطلاء: أعد تطبيق اللوحة"]
    notice["لاحظ: ColorValuesChanged"] --> ui["ارجع إلى خيط الواجهة"]
    ui --> read
    paint -.-> dwm["أعد ضبط سمة DWM أيضاً"]

الشكل 7: حلقة القراءة عند التشغيل والملاحظة بالإشعار والرجوع إلى خيط الواجهة وإعادة الطلاء هيكل تتبع السمة.

5.1. اقرأ ── UISettings و«إن كانت المقدّمة ساطعة فالداكن»

الإجراء الرسمي من Microsoft يستخدم Windows.UI.ViewManagement.UISettings في WinRT. خذ لون المقدّمة (لون النصّ الافتراضي) بـ GetColorValue(UIColorType::Foreground)، وقدّر السطوع المدرَك بحساب صحيح واحكم «هل هو ساطع»، وإن كانت المقدّمة ساطعة فاحكم وضعاً داكناً. تقطع الوثائق بأن هذه المعادلة ليست نموذجاً صارماً لتحليل السطوع بل تقريباً كافياً لتصنيف الفاتح/الداكن.³²¹

UISettings صنف WinRT، لكن يمكن استدعاؤه مباشرة من C# في WPF/WinForms إن جعلت TargetFramework يحمل إصدار Windows SDK مثل net8.0-windows10.0.19041.0 (الآلية في «WinRT هو COM»). هناك أيضاً قراءة AppsUseLightTheme في السجلّ مباشرة، لكن السجلّ موضع حفظ الإعداد لا عقد واجهة، فإن قرأت فاجعل UISettings الأصل والسجلّ للتشخيص.

flowchart TB
    accTitle: مسار قراءة وضع اللون
    accDescr: المسار النظامي أخذ لون المقدّمة بـ UISettings في WinRT والحكم على السطوع، وAppsUseLightTheme في السجلّ موضع حفظ يُترك للتشخيص
    q["هل الحالي فاتح أم داكن"] --> uis["UISettings.GetColorValue"]
    q -.-> reg["AppsUseLightTheme في السجلّ"]
    uis --> fg["احكم على السطوع المدرَك للون المقدّمة"]
    fg --> ans["إن كان ساطعاً فداكن"]
    reg -.-> diag["موضع حفظ. اتركه للتشخيص"]

الشكل 8: مسار القراءة النظامي UISettings، والسجلّ موضع حفظ فحسب.

5.2. لاحظ ── ColorValuesChanged لا يصل على خيط الواجهة

لكشف التغيير استخدم UISettings أيضاً. يقع حدث ColorValuesChanged عند تغيّر قيم اللون، والدليل الرسمي أيضاً يتتبع تغيّر الإعداد بهذا الحدث.⁵³ هنا تنبيه عملي واحد. لا ضمان لوصول هذا الحدث على خيط الواجهة. ارجع إلى خيط الواجهة بـ Dispatcher في WPF أو Control.Invoke في WinForms أو SynchronizationContext الصالح لكليهما ثمّ المس التحكّمات. معاملة خيط الواجهة ملخّصة في «تنظيم async وخيط الواجهة في WPF/WinForms في صفحة واحدة».

كذلك يقع هذا الحدث عند تغيّر لون التمييز. إن أردت إعادة الطلاء عند تغيّر الفاتح/الداكن فقط فاحكم من جديد عند كلّ حدث ولا تُشعر إلّا عندما يختلف عن السابق. ووفق أولوية الفصل 2، إن كانت سمة التباين مفعّلة فلا تنظر إلى سطوع لون المقدّمة. سمة تباين ذات خلفية داكنة مثل Aquatic مقدّمتها ساطعة، فالنظر إلى السطوع وحده يخطئ الحكم «داكن». احكم سمة التباين حالة مستقلّة أوّلاً.

الصنف التالي يجمع ترتيب الحكم هذا في واحد. مرّر من جهة الاستدعاء SynchronizationContext للرجوع إلى خيط الواجهة، وحكم سمة التباين (في WinForms SystemInformation.HighContrast، وفي WPF SystemParameters.HighContrast، الفصل 8). انتبه إلى توقيت الإنشاء. في WinForms عند Program.Main لا حلقة رسائل بعد ولا Control، وSynchronizationContext.Current هو null. مرّر SynchronizationContext.Current بعد إنشاء التحكّم، كما في منشئ النموذج أو OnLoad. في WPF يمكن تمرير new DispatcherSynchronizationContext(Application.Current.Dispatcher).

using Windows.UI.ViewManagement; // TargetFramework: net8.0-windows10.0.19041.0 فما بعده

public enum ThemeState { Light, Dark, HighContrast }

public sealed class SystemThemeWatcher : IDisposable
{
    private readonly UISettings _settings = new();
    private readonly SynchronizationContext _ui;
    private readonly Func<bool> _isHighContrast;

    private bool _disposed;

    public ThemeState Current { get; private set; }
    public event EventHandler? Changed;

    // ui: SynchronizationContext لخيط الواجهة. مرّر
    //     SynchronizationContext.Current بعد إنشاء التحكّم، أو في WPF DispatcherSynchronizationContext
    // isHighContrast: () => SystemInformation.HighContrast (WinForms)
    //                 () => SystemParameters.HighContrast (WPF)
    public SystemThemeWatcher(SynchronizationContext ui, Func<bool> isHighContrast)
    {
        _ui = ui ?? throw new ArgumentNullException(nameof(ui));
        _isHighContrast = isHighContrast ?? throw new ArgumentNullException(nameof(isHighContrast));
        Current = Read();
        _settings.ColorValuesChanged += OnColorValuesChanged;
    }

    private ThemeState Read()
    {
        // ترتيب الحكم كما في الفصل 2: سمة التباين أوّلاً. سمة تباين ذات خلفية داكنة
        // مقدّمتها ساطعة، فالنظر إلى السطوع وحده يخطئ الحكم «داكن»
        if (_isHighContrast()) return ThemeState.HighContrast;
        // الحكم نفسه في الدليل الرسمي: إن كانت المقدّمة (لون النصّ الافتراضي) ساطعة فداكن
        var fg = _settings.GetColorValue(UIColorType.Foreground);
        bool isDark = (5 * fg.G + 2 * fg.R + fg.B) > 8 * 128;
        return isDark ? ThemeState.Dark : ThemeState.Light;
    }

    // يُستدعى من خيط الواجهة. يمكن استدعاؤه أيضاً من إشعار مسار آخر مثل UserPreferenceChanged
    public void Refresh()
    {
        if (_disposed) return;
        var next = Read();
        // بين الفاتح والداكن لا تُشعر إن كانت الحالة نفسها لتجاهل تغيّر لون التمييز وحده ونحوه.
        // الاستثناء أثناء سمة التباين: تحرير المستخدم لألوان السمة يبقي الحالة HighContrast
        // فأعلم حتّى في الحالة نفسها لإعادة أخذ ألوان النظام
        if (next == Current && next != ThemeState.HighContrast) return;
        Current = next;
        Changed?.Invoke(this, EventArgs.Empty);
    }

    private void OnColorValuesChanged(UISettings sender, object args)
    {
        // لا ضمان للوصول على خيط الواجهة، فارجع إلى الواجهة ثمّ احكم وأعلم.
        // الاستدعاء الذي يصل بعد Dispose (كان في الطابور سلفاً) يُتجاهل بعلم Refresh
        _ui.Post(_ => Refresh(), null);
    }

    public void Dispose()
    {
        // إلغاء الاشتراك يوقف التسليم اللاحق فقط، وتبقى الاستدعاءات المُلقاة سلفاً على خيط الواجهة.
        // ارفع علماً واجعل جهة الاستدعاء المتبقّي تتجاهل (يُستدعى على خيط الواجهة)
        _disposed = true;
        _settings.ColorValuesChanged -= OnColorValuesChanged;
    }
}

على مستوى Win32 يُرسل WM_SETTINGCHANGE إلى كلّ نوافذ المستوى الأعلى عند تغيّر الإعداد،²² وفي .NET يصل ذلك بوصفه SystemEvents.UserPreferenceChanged.²³ عند تبديل النمط البصري (بما فيه تفعيل سمة التباين) يأتي WM_THEMECHANGED،²⁴ وعند تغيّر ألوان النظام يأتي WM_SYSCOLORCHANGE.²⁵ أمتن من كتابة معالجة منفصلة لكلّ نوع إشعار أن تستدعي المعالجة نفسها «اقرأ وأعد الطلاء» أيّاً كان الإشعار، وهذا الشكل نفسه لتتبع سمة التباين في المقالة السابقة. في SystemThemeWatcher أعلاه يعني استدعاء Refresh() أيضاً من معالج UserPreferenceChanged أو StaticPropertyChanged.

flowchart TB
    accTitle: مسارات إشعار تغيّر السمة والخيط
    accDescr: ColorValuesChanged في UISettings قد يصل خارج خيط الواجهة فارجع إلى الواجهة، وWM_SETTINGCHANGE يصل بوصفه SystemEvents.UserPreferenceChanged، وWM_THEMECHANGED وWM_SYSCOLORCHANGE يصلان إلى إجراء النافذة. اجمع كلاً في إعادة التطبيق نفسها
    cvc["ColorValuesChanged"] --> marshal["ارجع إلى خيط الواجهة"]
    upc["UserPreferenceChanged"] --> reapply["اقرأ وأعد الطلاء"]
    wm["WM_THEMECHANGED ونحوه"] --> reapply
    marshal --> reapply

الشكل 9: مسارات الإشعار متعدّدة، لكن اجمعها كلّها في المعالجة نفسها «اقرأ وأعد الطلاء».

5.3. أعد الطلاء ── اجمع الألوان في موضع واحد

فرض إمكان إعادة الطلاء أن الألوان مجتمعة في موضع واحد. إن تفرّق Color.White أو #FFFFFF في النموذج وXAML تعذّر تعداد مواضع إعادة الطلاء. في WinForms اصنع صنفاً «لوحة» (نسختان للفاتح والداكن) وخذ التحكّمات الألوان منها عند التشغيل وعند الإشعار. في WPF اجمع الألوان في ResourceDictionary واجعل XAML يشير بـ DynamicResource. في WinUI هذه البنية مُعدَّة من الأصل بوصفها ThemeDictionaries.

flowchart TB
    accTitle: بنية جمع الألوان في موضع واحد
    accDescr: احمل في التطبيق لوحة للفاتح ولوحة للداكن، ولتأخذ كلّ شاشة الألوان من اللوحة المختارة وفق الوضع الحالي، فيمكن تعداد أهداف إعادة الطلاء
    mode["الوضع الحالي"] --> sel{"أيّهما تُستخدم؟"}
    sel -->|فاتح| pl["لوحة الفاتح"]
    sel -->|داكن| pd["لوحة الداكن"]
    pl --> screens["كلّ شاشة وكلّ تحكّم"]
    pd --> screens
    hard["Color.White المتفرّق"] -.-> cannot["لا يمكن تعداد مواضع إعادة الطلاء"]

الشكل 10: إن حُملت اللوحة في موضع واحد أمكن تعداد إعادة الطلاء، والتثبيت البرمجي المتفرّق لا يمكن.

عمل «جمع الألوان» هذا ينفع كما هو في دعم سمة التباين وفي تأكيد نسبة التباين الآتي. أكبر تكلفة لدعم الوضع الداكن ليست استدعاء الواجهة بل هذا الترتيب.

6. التنفيذ في WinForms

6.1. .NET 9/10 ── Application.SetColorMode

دخل إلى WinForms دعم أولي للوضع الداكن في .NET 9، و«دُمج كاملاً» في .NET 10. القيم التي تُمرَّر إلى Application.SetColorMode ثلاث.⁶⁷

• SystemColorMode.Classic ── الافتراض. فاتح كما كان.
• SystemColorMode.System ── اتبع إعداد الفاتح/الداكن في Windows.
• SystemColorMode.Dark ── داكن.

موضع الاستدعاء قبل Application.Run، قبل إنشاء عناصر الواجهة. في .NET 9 كانت ميزة تجريبية فيصير خطأ ترجمة إن لم تُكبت WFO5001 في ملفّ المشروع، ومن .NET 10 لا يظهر هذا الخطأ.²⁶

static class Program
{
    [STAThread]
    static void Main()
    {
        ApplicationConfiguration.Initialize();
        Application.SetColorMode(SystemColorMode.System); // استدعِ قبل إنشاء الواجهة
        Application.Run(new MainForm());
    }
}

عندما يتغيّر وضع اللون تتبدّل System.Drawing.SystemColors إلى الألوان المقابلة، وتُرسم التحكّمات القياسية وفقها.⁶ الآلية أن الخاصّية التجريبية SystemColors.UseAlternativeColorSet (SYSLIB5002) «تجعل KnownColor للنظام يعيد مجموعة ألوان بديلة (حالياً نسخة الوضع الداكن)»، وألوان نظام Win32 نفسها لا تتغيّر بإعداد الفاتح/الداكن، فالمجموعة البديلة عند جهة .NET. الوثائق نفسها تقول أيضاً إن ألوان Windows الحالية تُعاد دائماً عندما تكون سمة التباين مفعّلة.²⁷

أمسك ثلاثة قيود مكتوبة في وثائق SetColorMode.²

1. وضع اللون الداكن متاح على Windows 11 فما بعده فقط.
2. الوضع الداكن غير متاح عندما تكون سمة التباين مفعّلة.
3. حتّى مع SystemColorMode.System لا يتبع التطبيق تلقائيّاً تغيّر إعداد Windows أثناء التشغيل.

الثالث موضع استفسار شائع في تطبيقات الأعمال. اكتب في الشرح للمستخدم أنّه يُقرَّر بإعداد Windows عند التشغيل ويسري عند التشغيل التالي. إن أردت حتماً التتبع أثناء التشغيل لزم تصميم إعادة إنشاء النموذج، وقلّما يستحقّ ذلك.

flowchart TB
    accTitle: تدفّق SetColorMode وقيوده
    accDescr: يُستدعى SetColorMode قبل Application.Run، فتتبدّل SystemColors إلى المجموعة البديلة وتتبع التحكّمات القياسية. القيود الثلاثة Windows 11 فقط، معطّل أثناء سمة تباين، لا يتبع تغيّر الإعداد أثناء التشغيل
    sc["SetColorMode (System)"] --> before["قبل Application.Run"]
    before --> colors["SystemColors إلى المجموعة البديلة"]
    colors --> ctrls["تتبع التحكّمات القياسية"]
    sc -.-> c1["Windows 11 فقط"]
    sc -.-> c2["معطّل أثناء سمة تباين"]
    sc -.-> c3["لا يتبع التغيّر أثناء التشغيل"]

الشكل 11: SetColorMode ينفع مرّة واحدة قبل التشغيل، وله ثلاثة قيود موثَّقة.

6.2. التحكّمات المرسومة ذاتيّاً وApplyThemingImplicitly

التحكّمات القياسية تتبع وضع لون التطبيق، لكن وثائق .NET 10 تذكر حالتين استثنائيتين. إن استخدمت داخل تحكّم تكوّنه وترسمه بنفسك تحكّمات Win32 مشتركة مثل أشرطة التمرير، بقيت فاتحة ما لم تشترك صراحة. وبالعكس، إن ورثت تحكّماً قائماً يتبع السمة وأردت التحكّم الكامل في الرسم فاخرج من الاشتراك.⁷

في الحالتين تجاوز Control.CreateParams واستدعِ SetStyle(ControlStyles.ApplyThemingImplicitly, true/false) قبل قراءة base.CreateParams. فخ هذه الواجهة أن منشئ الصنف الأساس يقرأ CreateParams، فمنشئك أنت متأخّر.⁷

public partial class GanttChartControl : Control
{
    protected override CreateParams CreateParams
    {
        get
        {
            // اضبط قبل قراءة base.CreateParams. في المنشئ متأخّر
            SetStyle(ControlStyles.ApplyThemingImplicitly, true);
            return base.CreateParams;
        }
    }
}

flowchart TB
    accTitle: توقيت يمكن فيه ضبط ApplyThemingImplicitly
    accDescr: يُقرَّر ApplyThemingImplicitly عندما يقرأ منشئ الصنف الأساس CreateParams، فيلزم استدعاء SetStyle داخل تجاوز CreateParams قبل base.CreateParams، ومنشئ الصنف المشتق متأخّر
    basector["منشئ الأساس"] --> cp["يقرأ CreateParams"]
    cp --> st["يلزم SetStyle قبل هنا"]
    st --> derived["منشئ الصنف المشتق"]
    derived -.-> late["الاستدعاء هنا متأخّر"]

الشكل 12: يجب أن يكون ApplyThemingImplicitly مقرَّراً قبل أن يقرأ منشئ الأساس CreateParams.

الرسم الذاتي نفسه (OnPaint برسم GDI+) يتبع المجموعة البديلة إن استخدمت SystemColors / SystemBrushes / SystemPens. المواضع المطلية بـ Color.White تُستبدل هنا أيضاً باللوحة السابقة.

6.3. .NET Framework 4.8 و.NET 8 فما قبله ── صرّح بـ «تثبيت الفاتح»

في بيئة بلا SetColorMode لا دعم قياسي للوضع الداكن. الخياران اثنان.

1. صرّح بتثبيت الفاتح. أبقِ سمة DWM على FALSE الافتراضي (شريط عنوان فاتح دائماً)، ومنطقة العميل كما كانت. دعم سمة التباين (الفصل 8) وحده لازم حتماً.
2. ادعم جملة بنفسك. اجمع اللوحة، واقرأ بـ UISettings واتبع، واجعل سمة DWM TRUE، وأعد طلاء مظهر التحكّمات المشتركة أيضاً كلّه.

الثاني يميل إلى حالة «داكن تقريباً لكن فاتح في مواضع» لأن التطبيق لا يتحكّم كاملاً في رسم تحكّمات Win32 المشتركة (أشرطة التمرير والترويسة وأزرار توسيع الشجرة وغيرها). كما يقول الدليل الرسمي «يلزم أن يتبع السطح كلّه»،³ الداكن الناقص تجربة أسوأ من تثبيت الفاتح. للأصل القائم اختيار 1 والتصريح بأن «هذا التطبيق عرض فاتح»، والتبديل إلى SetColorMode عند الترحيل إلى .NET 10 سياسة واقعية وأسهل شرحاً.

flowchart TB
    accTitle: خيارات WinForms حسب وقت التشغيل
    accDescr: على .NET 10 فما بعده استخدم SetColorMode، وعلى .NET 9 استخدم الواجهة نفسها مع كبت WFO5001، وعلى .NET 8 فما قبله و.NET Framework اختر التصريح بتثبيت الفاتح أو الدعم الكامل الذاتي بما فيه التحكّمات المشتركة
    q{"وقت التشغيل هو؟"}
    q -->|.NET 10 فما بعده| n10["SetColorMode (System)"]
    q -->|.NET 9| n9["SetColorMode + كبت WFO5001"]
    q -->|.NET 8 فما قبله / .NET Framework| legacy{"ماذا تفعل؟"}
    legacy -->|موصى به| fixed["صرّح بتثبيت الفاتح"]
    legacy -->|إن كنت مستعدّاً| full["ادعم جملة بنفسك"]
    full -.-> partial["تبقى التحكّمات المشتركة"]

الشكل 13: على أوقات تشغيل بلا SetColorMode يصير التصريح بتثبيت الفاتح الافتراض الواقعي.

7. التنفيذ في WPF

7.1. .NET 9/10 ── سمة Fluent وThemeMode

تضمّ WPF في .NET 9 سمة جديدة وفق تصميم Fluent في Windows 11، وتدعم الفاتح/الداكن ولون التمييز. طريقان للتطبيق: ضبط خاصّية ThemeMode، أو إضافة قاموس موارد PresentationFramework.Fluent إلى MergedDictionaries.⁸

قيم ThemeMode أربع: Light / Dark / System / None (الافتراض. سمة Aero2 التقليدية)، والضبط على Application ينفع التطبيق كلّه وعلى Window تلك النافذة فقط.⁸

<Application x:Class="OrderEntry.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml"
             ThemeMode="System">
</Application>

ThemeMode لا يحمّل قاموس سمة Fluent إلى الموارد فقط، بل منصوص أنّه «يتحكّم أيضاً في تطبيق مادّة الخلفية والوضع الداكن على النافذة». أي أن سمة DWM في الفصل 4 تتولاها جهة WPF. كذلك صُمِّم ThemeMode وResources ليعملان متزامنين، ويُشرح ذلك لتفادي عدم اتساق نافذة داكنة وتحكّمات داخلها فاتحة.¹⁰

flowchart TB
    accTitle: ما يفعله ThemeMode في WPF
    accDescr: جعل ThemeMode هو System يحمّل قاموس سمة Fluent الموافق لإعداد Windows إلى الموارد، ويتحكّم معه في تطبيق الوضع الداكن ومادّة الخلفية على النافذة
    tm["ThemeMode=System"] --> read["اقرأ إعداد Windows"]
    read --> dict["حمّل قاموس Fluent إلى الموارد"]
    read --> win["تغميق النافذة ومادّة الخلفية"]
    dict --> sync["تزامن مع Resources لتفادي عدم الاتساق"]

الشكل 14: يتحكّم ThemeMode معاً في تحميل قاموس Fluent وتغميق النافذة.

تنبيهان ينبغي معرفتها قبل الاعتماد. الأوّل أن قراءة ThemeMode وكتابته من الشيفرة ميزة تجريبية، والوصول يصير خطأ WPF0001. إن كبتّ أمكنت كتابة مثل Application.Current.ThemeMode = ThemeMode.Dark، لكن مرجع الواجهة يبقى [Experimental("WPF0001")] حتّى في .NET 10 ويلاحظ أنّه «قد يُحذف لاحقاً».⁸¹⁰ الثاني أن دعم نمط Fluent «قيد العمل» حتّى في .NET 10. في .NET 10 أُضيفت أنماط DatePicker وGridSplitter وGroupBox وTextBox وغيرها، وأُصلح انهيار مرتبط بـ HighContrast،⁹ أي أن Fluent في .NET 9 كان يفتقدها. قبل حكم الاعتماد أكّد على جهاز حقيقي أن التحكّمات المستخدمة في تطبيق الأعمال (خصوصاً DataGrid ومنتجات أطراف ثالثة) لا تنهار تحت Fluent.

7.2. التتبع مع بقاء السمة التقليدية ── تبديل ResourceDictionary

في WPF التي لا تعتمد Fluent (أو على .NET 8 فما قبله و.NET Framework) لا دعم قياسي للوضع الداكن. ألوان نظام Win32 لا تتغيّر بإعداد الفاتح/الداكن، فالإشارة إلى SystemColors في WPF لا تُعتم. بنية التتبع الذاتي كما يلي.

1. عرّف الألوان والفرش بالمفاتيح نفسها في Themes/Light.xaml للفاتح وThemes/Dark.xaml للداكن.
2. من XAML أشر بـ DynamicResource مثل {DynamicResource App.WindowBackgroundBrush} (StaticResource يُثبَّت عند التحميل فلا يتبع التبديل).
3. عند إشعار SystemThemeWatcher في الفصل 5 بدّل القاموس المقابل في MergedDictionaries. أثناء سمة التباين أيّ قاموس وضعت يُستبدل بألوان النظام بمحفّز 8.4، فأبقِ قاموس الفاتح.

public static class AppTheme
{
    private static readonly Uri Light = new("pack://application:,,,/Themes/Light.xaml");
    private static readonly Uri Dark = new("pack://application:,,,/Themes/Dark.xaml");

    public static void Apply(ThemeState state)
    {
        var merged = Application.Current.Resources.MergedDictionaries;
        var current = merged.FirstOrDefault(d => d.Source == Light || d.Source == Dark);
        // قاموس الداكن في الداكن فقط. أثناء سمة التباين أوكل إلى ألوان النظام (8.4)
        var next = new ResourceDictionary { Source = state == ThemeState.Dark ? Dark : Light };
        if (current is null)
        {
            merged.Add(next);
        }
        else
        {
            merged[merged.IndexOf(current)] = next; // بدّل في الموضع نفسه
        }
    }
}

flowchart TB
    accTitle: تبديل قاموس الموارد في WPF
    accDescr: عرّف الألوان بالمفاتيح نفسها في قاموس الفاتح وقاموس الداكن، واجعل XAML يشير بـ DynamicResource، وبدّل القاموس داخل MergedDictionaries عند إشعار تغيّر السمة فيُحدَّث موضع الإشارة
    notify["إشعار تغيّر السمة"] --> swap["بدّل القاموس في MergedDictionaries"]
    light["Light.xaml (المفاتيح نفسها)"] --> swap
    dark["Dark.xaml (المفاتيح نفسها)"] --> swap
    swap --> dyn["تُحدَّث إشارة DynamicResource"]
    static["إشارة StaticResource"] -.-> stale["تبقى قيمة وقت التحميل"]

الشكل 15: إن بدّلت قاموساً بالمفاتيح نفسها تبعت إشارة DynamicResource وحدها.

قوالب التحكّمات القياسية (خلفية الزرّ ولون شريط التمرير) تحمل ألوان السمة التقليدية، فتبقى هنا أيضاً مواضع «سطح التطبيق داكن والتحكّم القياسي فاتح». قدّر حجم العمل لتجاوز النمط لكلّ تحكّم يلزم، ثمّ قارن باعتماد Fluent أو تثبيت الفاتح.

7.3. شريط العنوان

إن استخدمت ThemeMode تولّته WPF. إن تتبّعت بنفسك مع بقاء السمة التقليدية فاستخدم ضبط سمة DWM من OnSourceInitialized في 4.2، وأعد الضبط أيضاً عند إشعار SystemThemeWatcher.

8. الرسم تحت سمة التباين ── احفظ أزواج ألوان النظام

8.1. الكشف والإشعار

في Win32 مرّر SPI_GETHIGHCONTRAST إلى SystemParametersInfo واستقبل بنية HIGHCONTRAST، واحكم ببتّ HCF_HIGHCONTRASTON في dwFlags. يلزم ضبط cbSize عند الاستدعاء.¹¹²⁸ تصنّف Microsoft هذا «الطريقة المدعومة الوحيدة لتأكيد وجود التباين العالي».¹²

bool IsContrastThemeActive()
{
    HIGHCONTRASTW hc{};
    hc.cbSize = sizeof(hc);
    if (!::SystemParametersInfoW(SPI_GETHIGHCONTRAST, sizeof(hc), &hc, 0))
    {
        // لا تغطّ الفشل بقيمة افتراضية. أظهره برمز خطأ يتبيّن منه السبب
        throw std::system_error(::GetLastError(), std::system_category(),
                                "SystemParametersInfo(SPI_GETHIGHCONTRAST)");
    }
    return (hc.dwFlags & HCF_HIGHCONTRASTON) != 0;
}

لكلّ إطار خاصّية تغلف هذا الاستدعاء.

دليل إمكانية الوصول في WinForms يطلب تأكيد HighContrast عند التشغيل والاستجابة للتغيّر بـ UserPreferenceChanged.¹³ SystemParameters.HighContrast في WPF مقابل لـ SPI_GETHIGHCONTRAST وHCF_HIGHCONTRASTON،²⁹ وتغيّر الخاصّية الثابتة يُشعَر بـ StaticPropertyChanged.³⁰ ThemeSettings في WinUI 3 يُنشأ مربوطاً بالنافذة بـ CreateForWindowId ويُشترَك في حدث Changed، وانتبه إلى أن الحدث يتوقّف إن لم تُبقِ مرجعاً إلى الكائن.³¹

flowchart TB
    accTitle: مسار كشف سمة التباين
    accDescr: SPI_GETHIGHCONTRAST في Win32 طريقة الحكم المدعومة الوحيدة، وSystemInformation.HighContrast في WinForms وSystemParameters.HighContrast في WPF وThemeSettings.HighContrast في WinUI 3 تُقدَّم مغلفة لهذا من كلّ إطار
    spi["SPI_GETHIGHCONTRAST (طريقة الحكم الوحيدة)"] --> wf["WinForms SystemInformation"]
    spi --> wpf["WPF SystemParameters"]
    spi --> winui["WinUI 3 ThemeSettings"]
    spi --> win32["Win32 استدعاء مباشر"]

الشكل 16: جذر الحكم واجهة Win32 واحدة، ولكلّ إطار خاصّية تغلفها.

8.2. مبدأ الرسم ── زوج المقدّمة والخلفية

تورد «High contrast parameter» من Microsoft ثلاثة أمور ينبغي للتطبيق فعلها عندما يكون التباين العالي مفعّلاً.¹¹

1. انقل كلّ الألوان إلى مجموعة واحدة من لون مقدّمة ولون خلفية. استخدم بـ GetSysColor زوج COLOR_WINDOWTEXT وCOLOR_WINDOW، أو زوج COLOR_BTNTEXT وCOLOR_BTNFACE.
2. احذف صور النقطية المعروضة خلف النصّ. عائق بصري لمن يحتاجون التباين العالي.
3. ارسم الصور متعدّدة الألوان بلون مقدّمة النصّ ولون الخلفية.

«الزوج» هو الجوهر. دليل Windows 8 فما بعده يشرح أن COLOR_HIGHLIGHTTEXT صُنع على فرض خلفية COLOR_HIGHLIGHT، وCOLOR_WINDOWTEXT على فرض خلفية COLOR_WINDOW، ويطلب عدم تثبيت لون النصّ برمجيّاً وجعل الواجهة لا تعتمد على السمة المطبَّقة لأن المستخدم يخصّص الألوان.¹² مثال الدليل نفسه «في Aero النصّ دائماً أسود ولون التحديد أزرق فاتح، لكن في High Contrast Black يصير لون التحديد أسود. إن افترضت نصّاً أسود واستخدمت لون تحديد النظام صار نصّاً أسود على أرض سوداء» هو بعينه «اختفى عرض الحالة» في المقدّمة.

دليل سمات التباين في Windows 11 يجعل هذا التقابل جدولاً.¹

و«ما لا ينبغي فعله» منصوص أيضاً. لا تستخدم GrayText لنصّ تكميلي أو تلميح (مخصّص لحالة التعطيل)، لا تستخدم Hotlight لغير الارتباط التشعّبي، لا تخلط مقدّمة وخلفية غير متوافقتين، لا تختر اللون بالمظهر وحده (المستخدم يغيّر الألوان فعليّاً). اجعل خلفية الصفحة واللوح والنافذة المنبثقة معيارها SystemColorWindow، وخلفيات الأوجه المتجاورة تصير اللون نفسه فافصل الحدود اللازمة فقط بإطار مخصّص لسمة التباين (يُوصى بـ 2px للقوائم المنبثقة والحوارات)، وهذا أيضاً توجيه تصميم.¹

flowchart TB
    accTitle: تدفّق تعذّر القراءة عند كسر الزوج
    accDescr: إن افترضت أن النصّ أسود واستخدمت لون تحديد النظام للخلفية وحدها صار لون التحديد أسود في High Contrast Black فنصّ أسود على أرض سوداء. إن أخذت المقدّمة والخلفية زوجاً بقيت القراءة ممكنة ولو حرّر المستخدم الألوان
    assume["افترض أن النصّ أسود"] --> hl["خلفية التحديد وحدها لون تحديد النظام"]
    hl --> black["في High Contrast Black لون التحديد أسود"]
    black --> broken["نصّ أسود على أرض سوداء"]
    pair["خذ المقدّمة والخلفية زوجاً"] --> ok["تبقى القراءة ممكنة ولو حرّر المستخدم الألوان"]
    edit["يحرّر المستخدم الألوان"] -.-> assume

الشكل 17: أخذ أحدهما فقط بلون النظام قد يصير نصّاً أسود على أرض سوداء، وأخذهما زوجاً يبقي القراءة ممكنة ولو حُرّرت الألوان.

flowchart TB
    accTitle: حكم الرسم تحت سمة التباين
    accDescr: إن كانت سمة التباين مفعّلة فانقل الألوان إلى أزواج ألوان النظام، واحذف الصور خلف النصّ، وارسم الرسوم متعدّدة الألوان بلوني المقدّمة والخلفية، ولا تستخدم ألواناً مثبَّتة برمجيّاً
    on["سمة التباين مفعّلة"] --> map["انقل الألوان إلى أزواج"]
    on --> img["احذف الصور خلف النصّ"]
    on --> multi["ارسم الرسوم متعدّدة الألوان بلونين"]
    on --> nohard["لا تستخدم ألواناً مثبَّتة برمجيّاً"]

الشكل 18: الرسم عندما تكون سمة التباين مفعّلة يُلخَّص في النقل والحذف والتحويل إلى لونين وترك التثبيت البرمجي.

8.3. التنفيذ في WinForms

التحكّمات القياسية في WinForms تتبع ألوان النظام إن تركت ForeColor / BackColor على الافتراض. ما تبدّله وفق الحكم هو مواضع اللون الخاصّ والرسم الذاتي فقط. مثال الدليل لصاقة صفراء على أرض زرقاء في الحالة العادية، وتعود تحت التباين العالي إلى SystemColors.Window / SystemColors.WindowText.¹³ شكل يضيف تفرّع سمة التباين إلى بنية اللوحة السابقة.

using Microsoft.Win32;

public partial class OrderForm : Form
{
    private readonly SynchronizationContext _ui;

    public OrderForm()
    {
        InitializeComponent();
        // بعد إنشاء التحكّم فـ WindowsFormsSynchronizationContext موجود
        _ui = SynchronizationContext.Current
              ?? throw new InvalidOperationException("أنشئ على خيط الواجهة.");
        ApplyColorScheme();
        SystemEvents.UserPreferenceChanged += OnUserPreferenceChanged;
    }

    private void ApplyColorScheme()
    {
        if (SystemInformation.HighContrast)
        {
            // أوكل جملة إلى ألوان النظام مع حفظ الزوج، وأزل الصورة خلف النصّ
            statusLabel.BackColor = SystemColors.Window;
            statusLabel.ForeColor = SystemColors.WindowText;
            headerPanel.BackgroundImage = null;
        }
        else
        {
            var p = AppPalette.Current; // لوحة الفاتح/الداكن (الفصل 5)
            statusLabel.BackColor = p.PanelBackground;
            statusLabel.ForeColor = p.PanelForeground;
            headerPanel.BackgroundImage = Properties.Resources.HeaderPattern;
        }
    }

    private void OnUserPreferenceChanged(object? sender, UserPreferenceChangedEventArgs e)
    {
        // لا ضمان لوصول هذا الحدث أيضاً على خيط الواجهة. ارجع إلى الواجهة ثمّ احكم من جديد بلا تضييق بالفئة
        _ui.Post(_ =>
        {
            if (IsDisposed) return;
            ApplyColorScheme();
        }, null);
    }

    // حدث ثابت فيتسرب النموذج إن لم تُزل. أزل في Dispose(bool) الذي يمرّ أيضاً بمسار يُتلف بلا إغلاق
    // (إن وُجد Dispose(bool) مولَّد من المصمّم فاكتب هناك)
    protected override void Dispose(bool disposing)
    {
        if (disposing)
        {
            SystemEvents.UserPreferenceChanged -= OnUserPreferenceChanged;
        }
        base.Dispose(disposing);
    }
}

الرسم الذاتي في OnPaint ارسمه بفرش نظام تحفظ الزوج مثل SystemBrushes.Window / SystemPens.WindowText، واستبدل رسماً متعدّد الألوان مثل دائرة ملوّنة تمثّل الحالة بإطار بلون المقدّمة ونصّ («يعمل» / «متوقّف»). العرض الذي لا يعتمد على اللون وحده هو حديث معيار النجاح 1.4.1 في المقالة السابقة.

flowchart TB
    accTitle: تفرّع تطبيق الألوان في WinForms
    accDescr: استدعِ ApplyColorScheme عند التشغيل وعند كلّ UserPreferenceChanged، فإن كان SystemInformation.HighContrast صادقاً فأوكل إلى أزواج ألوان النظام وأزل صورة الخلفية، وإن كان كاذباً فخذ الألوان من لوحة الفاتح/الداكن
    start["عند التشغيل / UserPreferenceChanged"] --> apply["ApplyColorScheme"]
    apply --> q{"SystemInformation.HighContrast؟"}
    q -->|صادق| sys["أوكل إلى أزواج SystemColors"]
    sys --> noimg["أزل صورة الخلفية"]
    q -->|كاذب| pal["خذ من لوحة الفاتح/الداكن"]

الشكل 19: في WinForms استدعِ المعالجة نفسها عند التشغيل وعند كلّ إشعار، وأوكل إلى ألوان النظام إن كانت سمة التباين.

8.4. التنفيذ في WPF

SystemColors في WPF إن أشرت إلى مفتاح موارد مثل WindowBrushKey بـ DynamicResource تُحدَّث تلقائيّاً عند تغيّر الفرشاة (الإشارة الثابتة التي تستخدم WindowBrush مباشرة لا تُحدَّث).³² لتبديل المظهر أثناء سمة التباين فقط أشر إلى قيمة SystemParameters.HighContrast من DataTrigger. لكن SystemParameters.HighContrast خاصّية ثابتة فلا تصير كما هي مصدراً حيّاً للربط. جهّز وكيلاً صغيراً واحداً يشترك في StaticPropertyChanged ويحفظ القيمة ويُشعر بـ INotifyPropertyChanged، واربط محدّداً ذلك المثيل في Source.³⁰

public sealed class ThemeSettings : INotifyPropertyChanged
{
    public static ThemeSettings Instance { get; } = new();

    public bool IsHighContrast { get; private set; } = SystemParameters.HighContrast;
    public event PropertyChangedEventHandler? PropertyChanged;

    private ThemeSettings()
    {
        // يُشعَر عندما تتغيّر الخاصّية الثابتة في SystemParameters (يُعاد أخذ SPI_GETHIGHCONTRAST)
        SystemParameters.StaticPropertyChanged += (_, e) =>
        {
            if (!string.IsNullOrEmpty(e.PropertyName)
                && e.PropertyName != nameof(SystemParameters.HighContrast)) return;
            IsHighContrast = SystemParameters.HighContrast;
            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(IsHighContrast)));
        };
    }
}

<!-- أعلن xmlns:local="clr-namespace:OrderEntry" سلفاً -->
<Style x:Key="CardStyle" TargetType="Border">
    <Setter Property="Background" Value="{DynamicResource App.CardBackgroundBrush}"/>
    <Setter Property="BorderBrush" Value="{DynamicResource App.CardBorderBrush}"/>
    <Setter Property="BorderThickness" Value="1"/>
    <Style.Triggers>
        <DataTrigger Binding="{Binding Source={x:Static local:ThemeSettings.Instance}, Path=IsHighContrast}"
                     Value="True">
            <!-- احفظ الزوج: الخلفية Window، والإطار والنصّ WindowText. اجعل الحدّ أثخن -->
            <Setter Property="Background"
                    Value="{DynamicResource {x:Static SystemColors.WindowBrushKey}}"/>
            <Setter Property="BorderBrush"
                    Value="{DynamicResource {x:Static SystemColors.WindowTextBrushKey}}"/>
            <!-- ورّث أيضاً إلى النصّ الداخلي. العناصر الابن التي تصرّح بـ Foreground تقطع التوريث فانتبه -->
            <Setter Property="TextElement.Foreground"
                    Value="{DynamicResource {x:Static SystemColors.WindowTextBrushKey}}"/>
            <Setter Property="BorderThickness" Value="2"/>
        </DataTrigger>
    </Style.Triggers>
</Style>

flowchart TB
    accTitle: إشارة ألوان النظام في WPF ومحفّز سمة التباين
    accDescr: الإشارة إلى مفتاح موارد SystemColors بـ DynamicResource تتبع تغيّر الفرشاة تلقائيّاً، والمحفّز المربوط بـ IsHighContrast في وكيل يشترك في StaticPropertyChanged يستجيب للتبديل أثناء التشغيل ويبدّل إلى ألوان تحفظ الزوج. الإشارة المباشرة إلى WindowBrush لا تُحدَّث
    key["أشر إلى WindowBrushKey بـ DynamicResource"] --> auto["تتبع تلقائي لتغيّر الفرشاة"]
    spc["StaticPropertyChanged"] --> proxy["IsHighContrast في الوكيل"]
    proxy --> trig["يستجيب DataTrigger"]
    trig --> pair["بدّل إلى ألوان تحفظ الزوج"]
    direct["أشر إلى WindowBrush مباشرة"] -.-> stale["لا تُحدَّث"]

الشكل 20: تتبع WPF التبديل أثناء التشغيل بإشارة ديناميكية إلى مفتاح الموارد وربط بوكيل ينقل تغيّر الخاصّية الثابتة.

حتّى عند استخدام سمة Fluent، اجعل تأكيد التشغيل تحت سمة التباين شرط اعتماد، على ضوء إصلاح الانهيار المرتبط بـ HighContrast في .NET 10.⁹

8.5. التنفيذ في WinUI 3

في WinUI 3 تتبع التحكّمات القياسية الفاتح/الداكن وسمة التباين من الأصل، وألوان التطبيق الخاصّة تُعرَّف في ResourceDictionary.ThemeDictionaries بمفاتيح Default (داكن) وLight وHighContrast. في HighContrast لا تثبّت الألوان برمجيّاً، وأشر إلى ألوان نظام ديناميكية مثل SystemColorWindowColor بـ ThemeResource. للتحكّم المخصّص الذي يحمل Light/Dark جهّز دائماً HighContrast أيضاً، وHighContrast مفتاح احتياطي عندما لا توجد سمة تباين عالٍ مسمّاة أخرى.³³¹

<ResourceDictionary.ThemeDictionaries>
    <ResourceDictionary x:Key="Default">
        <SolidColorBrush x:Key="App.CardBackgroundBrush" Color="#2B2B2B"/>
    </ResourceDictionary>
    <ResourceDictionary x:Key="Light">
        <SolidColorBrush x:Key="App.CardBackgroundBrush" Color="#F3F3F3"/>
    </ResourceDictionary>
    <ResourceDictionary x:Key="HighContrast">
        <SolidColorBrush x:Key="App.CardBackgroundBrush"
                         Color="{ThemeResource SystemColorWindowColor}"/>
    </ResourceDictionary>
</ResourceDictionary.ThemeDictionaries>

وآلية أخرى في WinUI اسمها HighContrastAdjustment، مفعّلة افتراضيّاً. تفرض نصّاً أبيض وخلفية تمييز سوداء للحفاظ على التباين، وإن جهّزت قاموس سمة يستخدم ألوان النظام استخداماً صحيحاً فاضبطها على None وأمرّر نمطك، وهذا توصية الدليل.¹

flowchart TB
    accTitle: حلّ ThemeDictionaries في WinUI
    accDescr: يُختار وفق السمة الحالية أحد القواميس Default (داكن) أو Light أو HighContrast، وفي HighContrast أشر إلى ألوان نظام ديناميكية بـ ThemeResource. HighContrast مفتاح احتياطي عندما لا توجد سمة تباين عالٍ مسمّاة
    theme{"السمة الحالية هي؟"}
    theme -->|داكن| def["قاموس Default"]
    theme -->|فاتح| light["قاموس Light"]
    theme -->|سمة تباين| hc["قاموس HighContrast"]
    hc --> sysc["أشر إلى SystemColor بـ ThemeResource"]
    hc -.-> fb["احتياطي عندما لا توجد سمة مسمّاة"]

الشكل 21: في WinUI يُختار قاموس كلّ سمة تلقائيّاً، وقاموس HighContrast يشير إلى ألوان النظام.

9. دعم الوضع الداكن ليس بديلاً عن دعم إمكانية الوصول

الإبلاغ بأن دعم الوضع الداكن «دعم لإمكانية الوصول» خطأ. العلاقة بينهما تُرتَّب كما يلي.

• معيار نسبة التباين ينطبق بالمثل على لوحة الداكن. معيار النجاح 1.4.3 في WCAG يطلب 4.5:1 للنصّ و3:1 للنصّ الكبير، ولا يتغيّر هذا إن كانت الخلفية داكنة.¹⁴ تصميم داكن يضع نصّاً رماديّاً وسطاً على خلفية رماديّة داكنة يحمل المشكلة نفسها لـ «رمادي فاتح على أرض بيضاء» في الفاتح.
• تجنّب الأسود الخالص والأبيض الخالص تصميم Windows 11. أفضل ممارسات Microsoft تشرح أن Windows 11 تجنّب الأبيض الخالص والأسود الخالص واعتمد درجات ألطف للعين.³⁴ وبالعكس، جعل الخلفية #000000 في الوضع الداكن يشتكي منه من يجدون تبايناً أشدّ من اللازم مع النصّ الساطع (هالة).
• مراعاة تنوّع إدراك اللون لازمة بمعزل عن السمة. دليل الألوان من Microsoft يطلب ألّا تجعل اللون وسيلة الإبلاغ الرئيسة بل تعزيزاً بصريّاً، وألّا تجعل توليفة الأحمر والأخضر التمييز الوحيد.³⁵¹⁵
• سمة التباين متطلّب مستقل عن الوضع الداكن. كما في الفصل 2 لا يتاح الوضع الداكن أثناء تفعيل سمة تباين، فمهما كمل دعم الداكن لا يصل إلى مستخدمي سمة التباين.

flowchart TB
    accTitle: علاقة الوضع الداكن بإمكانية الوصول
    accDescr: دعم الوضع الداكن مراعاة للذوق والبيئة، ومتطلّبات إمكانية الوصول من نسبة التباين والإبلاغ الذي لا يعتمد على اللون وحده ودعم سمة التباين يلزم استيفاؤها على حدة بمعزل عن السمة
    dark["دعم الوضع الداكن"] --> pref["مراعاة الذوق والبيئة"]
    a11y["إمكانية الوصول"] --> ratio["نسبة تباين 4.5:1"]
    a11y --> sole["لا تعتمد على اللون وحده"]
    a11y --> ct["دعم سمة التباين"]
    dark -.->|ليس بديلاً| a11y

الشكل 22: دعم الوضع الداكن مراعاة للذوق والبيئة، ومتطلّبات إمكانية الوصول تُستوفى على حدة.

من جهة أخرى عمل «جمع الألوان في موضع واحد» في الفصل 5 أساس لكليهما. إن كانت اللوحة في موضع واحد أمكن تعداد أهداف قياس نسبة التباين في الفاتح والداكن كلّاً، وكتابة تفرّع سمة التباين في الموضع نفسه. جمع اللوحة بمناسبة دعم الداكن، وتفقّد نسبة التباين وسمة التباين في الأثناء أكثر ترتيب كفاءة استثماراً.

10. اختيار السياسة ── التوصية حسب نوع التطبيق

flowchart TB
    accTitle: مسار الأصل القائم إلى دعم الداكن
    accDescr: الأصل القائم يصرّح أوّلاً بتثبيت الفاتح، وينهي حتماً دعم سمة التباين، ويجمع اللوحة استعداداً، ثمّ يرحّل إلى .NET 10 ويبدّل إلى SetColorMode أو ThemeMode. دعم الداكن الناقص تجربة أسوأ من تثبيت الفاتح فلا يُمرّ به
    now["صرّح بتثبيت الفاتح (الآن)"] --> ct["دعم سمة التباين (لازم)"]
    ct --> pal["جمع اللوحة (استعداد)"]
    pal --> mig["رحّل إلى .NET 10"]
    mig --> dark["بدّل إلى SetColorMode / ThemeMode"]
    now -.->|لا يُمرّ به| half["دعم داكن ناقص"]
    half -.-> worse["تجربة أسوأ من تثبيت الفاتح"]

الشكل 23: الأصل القائم يبدأ من تثبيت الفاتح، ويمضي عبر دعم سمة التباين وجمع اللوحة إلى دعم الداكن عند الترحيل إلى .NET 10.

«تثبيت الفاتح» ليس هزيمة. هو سلوك Windows الافتراضي نفسه، وسلوك موثَّق. أهون بكثير على المستخدم تطبيق متسق فاتحاً من تطبيق ناقص الداكن «شريط العنوان وحده أسود» أو «شريط التمرير وحده أبيض». لكن دعم سمة التباين وحده لا يمكن «تثبيته». هذا مجال الترتيبات التيسيرية في المقالة السابقة، وليس ذوق سمة بل مسألة إمكان الاستخدام.

11. قائمة تحقّق

بعد انتهاء الدعم أكّد على جهاز حقيقي بهذا الترتيب. يمكن تبديل الكلّ من شاشة الإعدادات في عشرات الثواني.

1. بدّل الفاتح/الداكن أثناء التشغيل. غيّر الوضع في «الإعدادات > التخصيص > الألوان»، وأكّد هل يتبع شريط العنوان ومنطقة العميل كلاهما، أو أنّه وفق المواصفة «يسري عند التشغيل التالي» (SetColorMode في WinForms لا يتبع).
2. أحدث إعادة إنشاء المقبض. في WinForms بدّل ShowInTaskbar أثناء التشغيل وأكّد بقاء سمة شريط العنوان.
3. جرّب سمات التباين الأربع كلّها. بدّل بـ Left Alt+Left Shift+PrintScreen، وأكّد في Aquatic وDesert وDusk وNight sky كلّاً أن النصّ والإطار وصفّ التحديد والعنصر المعطّل والرابط قابلة للقراءة.¹
4. حرّر ألوان سمة التباين. المستخدم يغيّر الألوان فعليّاً. حرّر الخلفية إلى لون متطرّف واكشف ما بقي من تثبيت برمجي.
5. انظر إلى السجلّ. أكّد أن الفشل يُسجَّل عندما يفشل DwmSetWindowAttribute أو SystemParametersInfo على نظام تشغيل مدعوم، وأن Windows 10 دون الإصدار 22000 يبدأ فاتحاً دون استدعاء سمة DWM.
6. قس نسبة التباين. في الفاتح والداكن كلّاً تفقّد توليفات لون النصّ ولون الخلفية في اللوحة بـ 4.5:1.¹⁴

flowchart TB
    accTitle: إجراء تحقّق دعم السمة
    accDescr: أكّد على جهاز حقيقي بهذا الترتيب: تبديل الفاتح/الداكن أثناء التشغيل، وإعادة إنشاء المقبض، وسمات التباين الأربع، وتحرير ألوان السمة، وتأكيد سجلّ الفشل، وقياس نسبة التباين
    s1["بدّل الفاتح/الداكن أثناء التشغيل"] --> s2["إعادة إنشاء المقبض"]
    s2 --> s3["سمات التباين الأربع"]
    s3 --> s4["حرّر ألوان السمة"]
    s4 --> s5["تأكيد سجلّ الفشل"]
    s5 --> s6["قياس نسبة التباين"]

الشكل 24: يبدأ التحقّق من تبديل الإعداد ويُختَم بتأكيد السجلّ ونسبة التباين.

12. الخلاصة

• سمة Windows محوران «فاتح/داكن» و«سمة تباين»، وما دامت الثانية مفعّلة لا يتاح الوضع الداكن. الحكم سمة التباين أوّلاً.
• شريط عنوان التطبيق القائم أبيض افتراض للتوافق، وتمرير TRUE لـ DWMWA_USE_IMMERSIVE_DARK_MODE في DwmSetWindowAttribute (القيمة 20، Windows 11 الإصدار 22000 فما بعده) يرسمه داكناً عندما يكون النظام داكناً. اضبط عند كلّ إنشاء HWND، وأبقِ الفشل في السجلّ.
• الوضع الحالي يُحكم بسطوع لون المقدّمة من UISettings.GetColorValue، ويُلاحَظ التغيير بـ ColorValuesChanged، وترجع إلى خيط الواجهة وتعيد الطلاء. اجمع الألوان في موضع واحد.
• في WinForms Application.SetColorMode(SystemColorMode.System) في .NET 9/10. أمسك القيود الثلاثة: Windows 11 فقط، معطّل أثناء سمة تباين، لا يتبع التغيّر أثناء التشغيل، وApplyThemingImplicitly للتحكّم الخاصّ.
• في WPF ThemeMode="System" في .NET 9/10. التشغيل من الشيفرة تجريبي وFluent قيد العمل فاعتمد بعد تقييم. في السمة التقليدية تبديل القاموس + DynamicResource.
• تحت سمة التباين احكم بسلسلة SPI_GETHIGHCONTRAST، وانقل الألوان إلى أزواج ألوان النظام، واحذف الصور خلف النصّ، وارسم الرسوم متعدّدة الألوان بلونين. GrayText لحالة التعطيل، وHotlight للروابط فقط.
• دعم الداكن ليس بديلاً عن دعم إمكانية الوصول. في الداكن أيضاً 4.5:1، ولا تعتمد على اللون وحده، ودعم سمة التباين لازم على حدة.
• للأصل القائم التصريح بـ «تثبيت الفاتح» حلّ واقعي، ودعم سمة التباين وحده لا يمكن تثبيته.

الخطوة الأولى الموصى بها اختيار شاشة رئيسة واحدة، وتفعيل سمة التباين أوّلاً بـ Left Alt+Left Shift+PrintScreen والتأمّل، ثمّ العودة بالمفتاح نفسه، ثمّ تبديل إعداد ألوان Windows إلى الداكن (ما دامت سمة التباين مفعّلة لا يتاح الوضع الداكن فجرّبهما منفصلين). في دقائق يتبيّن «أين يحمل تطبيقكم الألوان».

مقالات ذات صلة

• مدخل إلى إمكان الوصول في تطبيقات Windows ── الاستعداد لأتمتة الواجهة ومتطلّبات الترتيبات التيسيرية
• WinRT هو COM ── IInspectable و.winmd وإسقاط اللغات، ولماذا لا يزال WinUI يركب عقداً ثنائياً
• استدعاء Win32 API بأمان من C# ── دليل P/Invoke العملي (DllImport / LibraryImport / CsWin32)
• تنظيم async وخيط الواجهة في WPF/WinForms في صفحة واحدة
• دعم DPI العالي في WinForms ── أسباب الضباب والانهيار على شاشة 4K والمعالجة الواقعية
• دعم DPI العالي في WPF ── أسباب الضباب والتسييل رغم «القوّة أمام DPI» والمعالجة
• اختيار WinForms/WPF/WinUI - جدول قرار عملي

مجالات الاستشارة ذات الصلة

تتناول شركة كومورا سوفت ذ.م.م. دعم الوضع الداكن في تطبيقات أعمال WinForms/WPF (جمع اللوحة، وتقييم الترحيل إلى SetColorMode / ThemeMode في .NET 9/10، ودمج سمة DWM)، وتشخيص انهيار العرض تحت سمة التباين وإصلاحه، واستشارة تتبع السمة في أصل Win32/MFC. يمكن البدء من مرحلة «فعّلنا الوضع الداكن فجاءت شكاوى الموظّفين».

• تطوير تطبيقات Windows
• استشارة تقنية ومراجعة تصميم
• اتصل بنا

روابط مرجعيّة

مقالات ذات صلة

أحدث المقالات التي تشترك في نفس الوسوم. عمّق فهمك بمواضيع مرتبطة.

أين يتصل هذا الموضوع

ترتبط هذه المقالة بشكل طبيعي بصفحات الخدمات التالية.

الأسئلة الشائعة

أسئلة شائعة حول موضوع هذه المقالة.

حوّلت Windows إلى الوضع الداكن، لكن شريط عنوان تطبيق WinForms الداخلي ما زال أبيض. لماذا؟

لأن Windows لا يملك وسيلة لمعرفة ما إذا كان التطبيق يدعم الوضع الداكن، فيعامل كلّ النوافذ افتراضيّاً وضعاً فاتحاً للتوافق. منطقة غير العميل بما فيها شريط العنوان يرسمها مدير نوافذ سطح المكتب (DWM)، ولا يُرسم الإطار داكناً عندما يكون النظام داكناً إلّا بعد أن يمرّر التطبيق TRUE لـ DWMWA_USE_IMMERSIVE_DARK_MODE (القيمة 20) عبر DwmSetWindowAttribute. دعم هذه السمة موثَّق لـ Windows 11 الإصدار 22000 فما بعده. إن استخدمت Application.SetColorMode في WinForms على .NET 9 فما بعده، أو ThemeMode في WPF على .NET 9 فما بعده، يتولّى الإطار هذا الاستدعاء، فالاستدعاء الذاتي يقتصر على تطبيقات .NET 8 فما قبله و.NET Framework وWin32/MFC. وشريط عنوان أسود فوق منطقة عميل تبقى بيضاء يبدو أشدّ نشازاً. لا تفعّل هذه السمة إلّا عندما تكون جاهزاً لإعادة طلاء التطبيق كلّه داكناً.

هل الوضع الداكن وسمة التباين (التباين العالي) الشيء نفسه؟

لا. الفاتح/الداكن وضع اللون تحت الإعدادات > التخصيص > الألوان، ويستخدم لوحة واسعة تبدّل سطوع المقدّمة والخلفية. سمة التباين تُختار تحت الإعدادات > إمكانية الوصول > سمات التباين، وتستخدم لوحة مقيَّدة بنسبة تباين تبلغ تقريباً 7:1 فما فوق (الأنواع الأربعة المضمَّنة Aquatic وDesert وDusk وNight sky، إضافة إلى ألوان يحرّرها المستخدم). تنصّ وثائق Microsoft صراحة على عدم الخلط بينهما، ولا يتاح الوضع الداكن أثناء تفعيل سمة تباين (لا يقدّم SetColorMode في WinForms الداكن أثناء سمة تباين، وRequestedTheme في XAML تتجاوزه النظام). في التنفيذ احكم أوّلاً هل سمة التباين مفعّلة فإن كانت فأوكل الألوان جملة إلى ألوان النظام، وإلّا فاختر لوحة الفاتح أو الداكن. هذا ترتيب الأولوية.

ما أقصر طريق لجعل تطبيق WinForms يدعم الوضع الداكن؟

على .NET 9 فما بعده أقصر طريق استدعاء Application.SetColorMode(SystemColorMode.System) قبل Application.Run في Program.cs. في .NET 9 كانت ميزة تجريبية فلزم كبت WFO5001 في ملفّ المشروع، ومن .NET 10 تُستخدم بلا كبت. استدعاء SetColorMode يبدّل SystemColors إلى مجموعة بديلة للوضع الداكن، وتُرسم التحكّمات القياسية وفقها. التنبيهات ثلاثة. الأوّل أن الوضع الداكن متاح على Windows 11 فما بعده فقط ويُعطَّل أثناء سمة تباين. الثاني أنّه حتّى مع SystemColorMode.System لا يتبع التطبيق تغيّر إعداد Windows أثناء التشغيل (يسري عند التشغيل التالي). الثالث أنّ التحكّم المرسوم ذاتيّاً إن استخدم تحكّمات Win32 المشتركة مثل أشرطة التمرير يلزم تجاوز CreateParams واستدعاء SetStyle(ControlStyles.ApplyThemingImplicitly, true) قبل base.CreateParams (المنشئ متأخّر).

ماذا يفعل تطبيق WPF ليتبع الوضع الداكن؟

من .NET 9 فما بعده تضمّ WPF سمة جديدة وفق تصميم Fluent في Windows 11، ويكفي كتابة ThemeMode="System" على عنصر Application في App.xaml لتُحمَّل سمة Fluent الموافقة لإعداد الفاتح/الداكن في Windows. يتحكّم ThemeMode أيضاً في تغميق النافذة (شريط العنوان) وتطبيق مادّة الخلفية. لكن قراءة ThemeMode وكتابته من الشيفرة تجريبية حتّى في .NET 10 (WPF0001)، ونمط Fluent نفسه «ما زال قيد العمل» في وثائق .NET 10. عند اعتماده في تطبيق أعمال قرّر بعد تقييم أن التحكّمات المستخدمة لا تنهار تحت Fluent. إن بقيت على السمة التقليدية (وكذا .NET 8 فما قبله و.NET Framework) فجهّز ResourceDictionary للفاتح وآخر للداكن وبدّلهما في MergedDictionaries، واجعل جانب XAML يشير بـ DynamicResource، واستخدم UISettings.ColorValuesChanged لكشف التبديل. لشريط العنوان خذ HWND من WindowInteropHelper في SourceInitialized واستدعِ DwmSetWindowAttribute.

لماذا تختفي النصوص أو يتعذّر قراءتها تحت سمة التباين (التباين العالي)؟

السبب النموذجي تثبيت الألوان برمجيّاً، أو كسر زوج المقدّمة والخلفية من ألوان النظام. تحت سمة التباين يمكن للمستخدم تحرير ألوان الخلفية والنصّ والرابط وغيرها بحرّية، فتسقط كلّ فرضية من نوع «النصّ أسود» أو «صفّ التحديد أزرق فاتح». إن ثبّت الخلفية وحدها على #E6E6E6 مثلاً صارت المقدّمة بيضاء في بعض السمات، فيركب نصّ أبيض فوق رمادي فاتح ويتعذّر القراءة. المبادئ ثلاثة: الحكم على الحالة بـ SPI_GETHIGHCONTRAST (في WinForms SystemInformation.HighContrast، وفي WPF SystemParameters.HighContrast)، واستبدال الألوان كلّها بأزواج ألوان النظام الصحيحة (WindowText مع Window، وButtonText مع ButtonFace، وHighlightText مع Highlight)، وترك الصور خلف النصّ والرسوم متعدّدة الألوان والرسم بلون المقدّمة ولون الخلفية فقط. GrayText لحالة التعطيل، وHotlight للارتباط التشعّبي دون غيره. يصل التغيير عبر WM_SYSCOLORCHANGE وWM_THEMECHANGED (في .NET عبر SystemEvents.UserPreferenceChanged)، فاحسب الألوان هناك وأعد الرسم.

الملف الشخصي للمؤلف

صفحة الملف الشخصي لمؤلف المقالة.

غو كومورا

مؤسّس شركة كومورا سوفت ذ.م.م.

يركّز على تطوير برامج ويندوز، والاستشارات التقنية، والتحقيق في الأخطاء، ويتميّز في المشاريع التي تبقى فيها الأصول القديمة ناشطة، وفي تشخيص الأعطال التي يصعب تحديد سببها.