Обработка высокого разрешения и масштабирования в решении для Office

Многие конфигурации компьютеров и мониторов теперь поддерживают высокие разрешения (количество точек на дюйм) и обеспечивают возможность подключения нескольких мониторов c разными размерами и плотностью пикселей. Для этого приложениям требуется выполнять настройку, если пользователь перемещает их на монитор с другим разрешением или изменяет масштаб. Приложения, не поддерживающие масштабирование, могут выглядеть нормально на мониторах c низким разрешением, но будут растянутыми и размытыми при отображении на мониторах с высоким разрешением.

Приложения Office 2016, такие как Word и Excel, были обновлены, чтобы реагировать на изменения коэффициента масштаба. Однако решение для Office также должно реагировать на изменения, чтобы правильно отображаться. В этой статье описано, как Office поддерживает динамическое разрешение и какие действия можно предпринять, чтобы обеспечить оптимальный интерфейс просмотра для решения по расширению Office при использовании масштабирования.

Проблемы масштабирования в решении

Windows применяет масштабирование, если приложение перемещается между мониторами с разным разрешением. Это происходит в таких случаях, как перетаскивание приложения на другой монитор или подключение ноутбука. Если масштабирование негативно влияет на решение для Office, появится одна или несколько из указанных ниже проблем.

• Окно отображается в неправильном месте или с неправильным размером.
• Элементы, например кнопки и подписи, отображаются в неправильном месте окна решения.
• Шрифты и изображения отображаются слишком маленькими, слишком большими или в неправильном месте.

Ниже указаны типы решений для Office, на которые может влиять масштабирование.

• Надстройки VSTO
• Настраиваемые области задач
• Надстройки COM
• Элементы ActiveX
• Расширения ленты
• OLE-серверы
• Веб-надстройки Office

Режимы поддержки определения DPI Windows

В этой статье используются режимы поддержки определения DPI, допустимые в Windows. Каждый из режимов поддержки определения DPI допускает применение разных возможностей, как указано в таблице ниже. Это упрощенное описание режимов для объяснения способов их поддержки решениями для Office. Дополнительные сведения о режимах поддержки определения DPI см. в статье Разработка классических приложений с высоким разрешением для Windows.

Режим	Описание	При изменении разрешения
Без поддержки определения DPI	Приложение всегда отображается как для дисплея со значением 96 точек на дюйм.	Приложение — растровое изображение, растянутое до нужного размера на основном и дополнительном дисплеях.
Поддержка определения DPI на уровне системы	Приложения определяют разрешение основного подключенного монитора при входе в Windows, но не могут реагировать на изменение разрешения. Дополнительные сведения см. в разделе Настройка Windows для устранения размытости приложений этой статьи.	Приложение — растровое изображение, растягиваемое при перемещении на новый дисплей с другим разрешением.
Поддержка определения DPI на уровне монитора	При изменении разрешения приложение может правильно изменить свое отображение.	Windows отправляет уведомления о разрешении для окон верхнего уровня в приложении, чтобы оно могло изменить отображение при изменении разрешения.
На уровне монитора версия 2	При изменении разрешения приложение может правильно изменить свое отображение.	Windows отправляет уведомления о разрешении для окон верхнего и дочернего уровня, чтобы приложение могло изменить отображение при изменении разрешения.

Как Office поддерживает масштабирование

Самый важный фактор при определении способа обработки масштабирования решением для Office состоит в том, является ли ваше решение окном верхнего или дочернего уровня. На рисунке ниже показано несколько примеров решений для Office, работающих как окна верхнего или дочернего уровня, а также применяемый ими режим поддержки определения DPI в обновлении Windows за апрель 2018 г. (1803) или более позднем.

На этом рисунке:

• Окно верхнего уровня COM или VSTO использует поддержку определения DPI на уровне монитора.
• Дочернее окно элемента ActiveX использует поддержку определения DPI на уровне системы.
• Окно верхнего уровня Office использует поддержку определения DPI на уровне монитора.
• Дочернее окно настраиваемой области задач использует поддержку определения DPI на уровне системы.

Управление контекстом DPI потока

При запуске ведущего приложения Office его основной поток выполняется в контексте поддержки определения DPI на уровне монитора. Если код решения создает потоки или получает вызовы от Office, требуется управлять контекстом DPI потока.

Создание новых потоков с правильным контекстом DPI

Если ваше решение создает дополнительные потоки, Office принудительно переводит эти потоки в контекст поддержки определения DPI на уровне монитора. Если в вашем коде предполагается другой контекст, необходимо использовать функцию SetThreadDpiAwarenessContext для установки нужной поддержки определения DPI потока.

Создание контекстного блока для входящих вызовов потока

Ваше решение взаимодействует с ведущим приложением Office, поэтому в решение будут поступать входящие вызовы от Office, например обратные вызовы событий. Когда Office вызывает решение, используется контекстный блок, принудительно устанавливающий в качестве контекста потока поддержку определения DPI на уровне системы. Необходимо изменить контекст потока в соответствии с поддержкой определения DPI вашего окна. Можно реализовать похожий контекстный блок, чтобы переключать контекст потока для входящих вызовов. Используйте функцию SetThreadDpiAwarenessContext, чтобы изменить контекст в соответствии с контекстом вашего окна.

Примечание.

Ваш контекстный блок должен восстановить исходный контекст DPI потока перед вызовом других компонентов за пределами кода решения.

Контекстный блок управляемого кода

В приведенном ниже примере кода показано, как создать собственный контекстный блок.

public struct DPI_AWARENESS_CONTEXT
        {
            private IntPtr value;

            private DPI_AWARENESS_CONTEXT(IntPtr value)
            {
                this.value = value;
            }

            public static implicit operator DPI_AWARENESS_CONTEXT(IntPtr value)
            {
                return new DPI_AWARENESS_CONTEXT(value);
            }

            public static implicit operator IntPtr(DPI_AWARENESS_CONTEXT context)
            {
                return context.value;
            }

            public static bool operator ==(IntPtr context1, DPI_AWARENESS_CONTEXT context2)
            {
                return AreDpiAwarenessContextsEqual(context1, context2);
            }

            public static bool operator !=(IntPtr context1, DPI_AWARENESS_CONTEXT context2)
            {
                return !AreDpiAwarenessContextsEqual(context1, context2);
            }

            public override bool Equals(object obj)
            {
                return base.Equals(obj);
            }

            public override int GetHashCode()
            {
                return base.GetHashCode();
            }
        }

        private static DPI_AWARENESS_CONTEXT DPI_AWARENESS_CONTEXT_HANDLE = IntPtr.Zero;

        public static readonly DPI_AWARENESS_CONTEXT DPI_AWARENESS_CONTEXT_INVALID = IntPtr.Zero;
        public static readonly DPI_AWARENESS_CONTEXT DPI_AWARENESS_CONTEXT_UNAWARE = new IntPtr(-1);
        public static readonly DPI_AWARENESS_CONTEXT DPI_AWARENESS_CONTEXT_SYSTEM_AWARE = new IntPtr(-2);
        public static readonly DPI_AWARENESS_CONTEXT DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE = new IntPtr(-3);
        public static readonly DPI_AWARENESS_CONTEXT DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2 = new IntPtr(-4);

        public static DPI_AWARENESS_CONTEXT[] DpiAwarenessContexts =
        {
            DPI_AWARENESS_CONTEXT_UNAWARE,
            DPI_AWARENESS_CONTEXT_SYSTEM_AWARE,
            DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE,
            DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2
        };

class DPIContextBlock : IDisposable
    {
        private DPI_AWARENESS_CONTEXT resetContext;
        private bool disposed = false;

        public DPIContextBlock(DPI_AWARENESS_CONTEXT contextSwitchTo)
        {
            resetContext = SetThreadDpiAwarenessContext(contextSwitchTo);
         }

        public void Dispose()
        {
            Dispose(true);
            GC.SuppressFinalize(this);
        }

        protected virtual void Dispose(bool disposing)
        {
            if (!disposed)
            {
                if (disposing)
                {
                    SetThreadDpiAwarenessContext(resetContext);
                }
            }
            disposed = true;
        }
    }

Контекстный блок машинного кода

#include <winuser.h>
/* DpiAwarenessContextBlock can be used to simplify setting and resetting the DPI_AWARENESS_CONTEXT of
the current thread.  When the object is constructed, the DPI_AWARENESS_CONTEXT is set, and when the object is
destructed, the DPI awareness context is reverted to the previous awareness context at construct time.

This object allows us to write code such as:

// Thread state is currently DPI_AWARENESS_SYSTEM_AWARE
if (condition)
{
DpiAwarenessContextBlock perMonitorAware(DPI_AWARENESS_PER_MONITOR_AWARE);
... // Create a top-level hwnd with the current thread state, DPI_AWARENESS_PER_MONITOR_AWARE
}
// Thread state automatically returns to DPI_AWARENESS_SYSTEM_AWARE

*/
class DpiAwarenessContextBlock
{
public:
      DpiAwarenessContextBlock(DPI_AWARENESS_CONTEXT dpiContext) noexcept;
      ~DpiAwarenessContextBlock();

      // Copy and move are not to be used with these context objects
      DpiAwarenessContextBlock(const DpiAwarenessContextBlock&) = delete;
      DpiAwarenessContextBlock(DpiAwarenessContextBlock&&) = delete;

private:
      DPI_AWARENESS_CONTEXT m_contextReversalType;
      bool m_doContextSwitch;
};

inline DpiAwarenessContextBlock::DpiAwarenessContextBlock(DPI_AWARENESS_CONTEXT dpiContext) noexcept
{
      m_contextReversalType = SetThreadDpiAwarenessContext(dpiContext);
}

inline DpiAwarenessContextBlock::~DpiAwarenessContextBlock()
{
      SetThreadDpiAwarenessContext(m_contextReversalType);
}

Управление окнами верхнего уровня

При запуске приложения Office вызывается функция SetThreadDpiAwarenessContext как DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE. В этом контексте изменения разрешения отправляются в свойство HWND любого окна верхнего уровня в процессе, выполняемом с поддержкой определения DPI на уровне монитора. Окна верхнего уровня — это окно приложения Office и все дополнительные окна верхнего уровня, созданные вашим решением. При перемещении приложения Office на новый дисплей оно получает уведомление, чтобы иметь возможность динамически изменить масштаб и правильно отобразиться в разрешении нового дисплея. Решение для Office может создавать окна верхнего уровня с любым режимом поддержки определения DPI. Ваши окна верхнего уровня также могут реагировать на изменения разрешения, прослушивая сообщения Windows на изменения.

Если вы создаете окна, дочерние по отношению к родительскому окну верхнего уровня, для них можно установить любой режим поддержки определения DPI. Однако при использовании режима поддержки определения DPI на уровне монитора дочерние окна не будут получать уведомления об изменении разрешения. Дополнительные сведения о режимах поддержки определения DPI в Windows см. в статье Разработка классических приложений с высоким разрешением для Windows.

Управление дочерними окнами

При работе с элементами ActiveX и настраиваемыми областями задач Office создает дочернее окно для вашего решения. Вы можете создать дополнительные дочерние окна, но нужно учитывать режим поддержки определения DPI родительского окна. Office работает в режиме поддержки определения DPI на уровне монитора. Это означает, что ни одно дочернее окно в решении не будет получать уведомления об изменении разрешения. Только режим на уровне монитора версии 2 поддерживает отправку изменений разрешения дочерним окнам (Office не поддерживает режим на уровне монитора версии 2). Однако для элементов ActiveX есть обходное решение. Дополнительные сведения см. ниже в разделе Элементы ActiveX.

Примечание.

Если дочернее окно создает окно верхнего уровня, можно использовать любой режим поддержки определения DPI для нового окна верхнего уровня. Дополнительные сведения об управлении окнами верхнего уровня см. в разделе Управление окнами верхнего уровня этой статьи.

В зависимости от версии Windows 10, на которой работает Office, к дочернему окну могут применяться два разных режима поддержки определения DPI.

Режим DPI для Office в Windows Fall Creators Update (1709)

Так как в приложениях Office используется режим поддержки определения на уровне монитора, дочерние окна вашего решения также создаются в этом режиме. Это означает, что Windows ожидает обновления вашего решения при отображении в новом разрешении. Так как ваше окно не может получать уведомления об изменении разрешения, пользовательский интерфейс решения может отображаться неправильно.

Режим DPI для Office в обновлении Windows за апрель 2018 г. (1803)

В обновлении Windows за апрель 2018 г. (1803) и более поздних версиях в качестве режима DPI ведущего приложения Office используется смешанный режим масштабирования для некоторых сценариев. Это позволяет окнам с поддержкой определения DPI на уровне системы использовать в качестве родительских окна Office с режимом поддержки определения DPI на уровне монитора. Это помогает улучшить совместимость при изменениях разрешения, если окна являются растянутыми растровыми изображениями. Окна по-прежнему могут отображаться размыто из-за растяжения растрового изображения.

При создании новых дочерних окон убедитесь, что их поддержка определения DPI соответствует родительскому окну. Вы можете использовать функцию GetWindowDpiAwarenessContext , чтобы получить представление о DPI родительского окна. Дополнительные сведения о согласовании поддержки определения DPI см. в разделе "Принудительный сброс поддержки определения DPI на уровне процесса" статьи Разработка классических приложений с высоким разрешением для Windows.

Примечание.

Нельзя полагаться на поддержку определения DPI на уровне процесса, поскольку она может вернуть значение PROCESS_SYSTEM_DPI_AWARE, даже если контекст поддержки определения DPI основного потока приложения соответствует значению DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE. Используйте функцию GetThreadDpiAwarenessContext, чтобы получить контекст поддержки определения DPI потока.

Параметры совместимости разрешений Office и Windows

Если надстройки или решения отображаются неправильно, можно использовать параметры совместимости, которые могут помочь исправить проблему.

Настройка Office для оптимизации обеспечения совместимости

В Office есть настройка оптимизации для обеспечения совместимости при переходе на другой масштаб на разных экранах. Режим совместимости отключает масштабирование, чтобы в качестве всех элементов Office использовалось растровое изображение, растягиваемое при перемещении на дисплей с другим масштабом.

Режим совместимости принудительно переводит Office в режим поддержки определения DPI на уровне системы. Это приводит к растягиванию растровых изображений окон приложения и в качестве побочного эффекта может вызывать размытый внешний вид. Ваше решение для Office не может управлять этой настройкой, так как ее выбирает пользователь. Использование режима совместимости дисплея решает большинство проблем отображения. Дополнительные сведения см. в статье Поддержка мониторов с высоким разрешением в Office.

Настройка Windows для исправления размытых приложений

В Windows 10 (версия 1803) и более поздних версиях есть настройка, исправляющая размытость приложения. Это еще одна настройка, которой можно воспользоваться, если решение отображается неправильно. Ваше решение для Office не может управлять этой настройкой, так как ее выбирает пользователь. Дополнительные сведения см. в статье Исправление размытости приложений в Windows 10.

Поддержка масштабирования в решении

Некоторые решения могут получать уведомления об изменениях разрешения и реагировать на них. В некоторых есть обходное решение, если они не могут получать уведомления. В таблице ниже перечислены сведения для каждого типа решения.

Тип решения	Тип окна	Возможность реакции на масштабирование	Дополнительные сведения
Надстройка VSTO	Верхний уровень и его дочерние окна	Да	См. рекомендации для надстройки VSTO.
	Дочерние для родительского окна Office	Нет	См. Настройка Office для оптимизации обеспечения совместимости.
Настраиваемая область задач	Верхний уровень и его дочерние окна	Да	См. рекомендации для окна верхнего уровня.
	Дочерние для родительского окна Office	Нет	См. Настройка Office для оптимизации обеспечения совместимости.
Надстройка COM	Верхний уровень и его дочерние окна	Да	См. рекомендации для надстройки COM.
	Дочерние для родительского окна Office	Нет	См. Настройка Office для оптимизации обеспечения совместимости.
Элемент ActiveX	Верхний уровень и его дочерние окна	Да	См. рекомендации для элемента ActiveX.
	Дочерние для родительского окна Office	Да
Веб-надстройка	Н/Д	Да	См. рекомендации для веб-надстройки Office.
Расширение ленты	Н/Д	Н/Д	См. рекомендации для расширения ленты.
OLE-сервер или клиент	Н/Д	Н/Д	См. рекомендации для OLE-сервера или клиента.

Надстройка VSTO

Если надстройка VSTO создает окна, дочерние по отношению к любому родительскому окну Office, убедитесь, что их поддержка определения DPI соответствует родительскому окну. Можно использовать функцию GetWindowdpiAwarenessContext, чтобы получить режим поддержки определения DPI родительского окна. Дочерние окна не будут получать уведомлений об изменении разрешения. Если ваше решение отображается неправильно, пользователям нужно будет перевести Office в режим совместимости.

Для любого окна верхнего уровня, создаваемого надстройкой VSTO, можно установить любой режим поддержки определения DPI. В приведенном ниже примере кода показано, как настроить нужную поддержку определения DPI и как реагировать на изменения разрешения. Вам также потребуется настроить app.config, как описано в статье Поддержка высокого разрешения в Windows Forms.

using System;
using System.Diagnostics;
using System.Drawing;
using System.Runtime.InteropServices;
using System.Windows.Forms;

namespace SharedModule
{
    // DpiAwareWindowsForm
    // For any top level winform you create, derive from the DpiWindowsForm class
    // if you are creating Windows Forms with the Dpi Awareness Context set to 
    // DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE or DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2
    //
    // For example, if you Window form class is defined as:
    //    public partial class TopLevelWinForm : Form
    //
    // update to:
    //    public partial class TopLevelWinForm : DpiAwareWindowsForm
    //
    // When showing the form, call SetThreadDpiAwarenessContext() or use a context block to
    // to set the desired Dpi Awareness Context.
    //
    // For example, here is code to show a Windows Form using a context block as Per Monitor Aware v2.
    //
    //    DPIContextBlock context = new DPIContextBlock(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2);
    //    TopLevelWinForm frm = new TopLevelWinForm();
    //    frm.Show();
    //
    public partial class DpiAwareWindowsForm : Form
    {
        private SizeF m_newDpi = SizeF.Empty;
        private SizeF m_oldDpi = SizeF.Empty;

        public DpiAwareWindowsForm()
        {
            this.HandleCreated += new EventHandler((sender, args) =>
            {
                m_oldDpi = m_newDpi = DPIHelper.GetDpiForWindowSizeF(this.Handle);
            });
        }

        public void OnDpiChangedEvent(RECT newRect)
        {
            this.SuspendLayout();

            // Resize form
            this.Width = newRect.Width;
            this.Height = newRect.Height;

            // Resize controls and set font sizes
            ScaleAllChildControls(this.Controls, m_oldDpi.Width, m_newDpi.Width);
            this.ResumeLayout(true);
        }

        // Additional changes may be needed for controls that set Anchor or Dock properties 
        private void ScaleAllChildControls(Control.ControlCollection controls, float oldDpi, float newDpi)
        {
            float scaleFactorChange = newDpi / oldDpi;

            foreach (Control control in controls)
            {
                control.Top = (int)(control.Top * scaleFactorChange);
                control.Left = (int)(control.Left * scaleFactorChange);
                control.Width = (int)(control.Width * scaleFactorChange);
                control.Height = (int)(control.Height * scaleFactorChange);
                control.Font = ScaleFont(control.Font, oldDpi, newDpi);
            }
        }

        private Font ScaleFont(Font font, float oldDpi, float newDpi)
        {
            float fontSizePx = 0.0f;
            float fontSizePt = 0.0f;

            fontSizePx = font.SizeInPoints / 72 * oldDpi;
            fontSizePt = fontSizePx * (newDpi / oldDpi) * 72 / oldDpi;

            return new Font(font.Name, fontSizePt, font.Style, GraphicsUnit.Point);
        }

        protected override void WndProc(ref Message m)
        {
            switch ((DPIHelper.WinMessages)m.Msg)
            {
                case DPIHelper.WinMessages.WM_DPICHANGED:
                    // Marshal the value in the lParam into a Rect.
                    RECT newDisplayRect = (RECT)Marshal.PtrToStructure(m.LParam, typeof(RECT));

                    // Remember current DPI and calculate current from WParam.
                    // Both X and Y are the same on Windows for Dpi.
                    m_oldDpi = m_newDpi;

                    m_newDpi.Width = (float)(m.WParam.ToInt32() >> 16);
                    m_newDpi.Height = (float)(m.WParam.ToInt32() & 0x0000FFFF);

                    // DPI should be the same for both width and height on Windows devices.
                    Debug.Assert(m_newDpi.Height == m_newDpi.Width);

                    if (m_oldDpi.Width != m_newDpi.Width)
                    {
                        OnDpiChangedEvent(newDisplayRect);
                    }
                    base.DefWndProc(ref m);
                    break;
                default:
                    base.WndProc(ref m);
                    break;
            }
        }
    }
}

Настраиваемые области задач

Настраиваемая область задач создается приложением Office в виде дочернего окна. При использовании обновления Windows Fall Creators Update (1709) настраиваемая область задач запускается с использованием такого же режима поддержки определения DPI, как в Office. При использовании обновления Windows за апрель 2018 г. (1803) и более поздней версии настраиваемая область задач запускается с использованием режима поддержки определения DPI на уровне системы.

Так как настраиваемые области являются дочерними окнами, они не могут получать уведомления о разрешении. Если они отображаются неправильно, пользователю потребуется использовать Режим совместимости разрешений в Office. Если настраиваемая область задач создает окна верхнего уровня, эти окна могут запускаться в любом режиме поддержки определения DPI и получать уведомления об изменении разрешения. Дополнительные сведения см. в разделе Управление окнами верхнего уровня этой статьи.

Надстройки COM

Надстройки COM, создающие окна верхнего уровня могут получать уведомления об разрешении. Необходимо создать контекстный блок и установить для потока поддержку определения DPI, необходимую для окна, а затем создать окно. Существует много нюансов для правильной обработки уведомлений о разрешении, поэтому обязательно ознакомьтесь с дополнительными сведениями в статье Разработка классических приложений с высоким разрешением для Windows.

Сообщение WM_DPICHANGED отправляется при изменении разрешения для окна. В неуправляемом коде это сообщение обрабатывается с помощью процедуры окна для свойства HWND. Пример кода обработчика изменения разрешения можно найти в статье WM_DPICHANGED.

Надстройки COM, отображающие окна, дочерние по отношению к родительскому окну в Office, не могут получать уведомления о разрешении. Если они отображаются неправильно, пользователю потребуется использовать Режим совместимости разрешений в Office.

Элементы ActiveX

Способ поддержки масштабирования в элементах ActiveX зависит от того, есть ли у элемента окна или нет.

Элементы ActiveX с окнами

Элементы ActiveX с окнами получают сообщение, WM_SIZE каждый раз, когда изменяется размер элемента. При возникновении этого события код обработчика события может вызвать функцию GetDpiForWindow с помощью свойства HWND элемента управления, чтобы получить значение разрешения, рассчитать разницу коэффициентов масштаба и выполнить соответствующую настройку.

В приведенном ниже примере включается элемент ActiveX на основе MFC, чтобы ответить на событие OnSize.

void ChangeWindowFontDPI(HWND hWnd, UINT dpi) 
{ 
LOGFONT fontInfo1 = { 0 }; 
// Calculate the font height based on the DPI. 
fontInfo1.lfHeight = -MulDiv(DESIRED_HEIGHT, dpi, 72); 
fontInfo1.lfQuality = CLEARTYPE_QUALITY; 
wcscpy_s(fontInfo1.lfFaceName, DESIRED_FONT_NAME); 
 
::SendMessage(hWnd, WM_SETFONT, (WPARAM)::CreateFontIndirectW(&fontInfo1), TRUE); 
} 
 
BOOL CALLBACK CMainDialog::EnumChildProc(HWND hWnd, LPARAM lParam) 
{ 
CMainDialog* _this = (CMainDialog*) lParam; 
if (_this != nullptr) 
{ 
// Calculate the scale factor difference between the old and new DPI changes. 
double scale = (((double) _this->m_newDPI) /  
   (((double) _this->m_currentDPI) / 100.0)) / 100; 
 
RECT rect = {}; 
::GetWindowRect(hWnd, &rect); 
 
POINT pt = { rect.left, rect.top }; 
::ScreenToClient(::GetParent(hWnd), &pt); 
 
// Adjust the window based on the scale changes. 
::MoveWindow(hWnd, 
pt.x * scale, 
pt.y * scale, 
(rect.right - rect.left) * scale, 
(rect.bottom - rect.top) * scale, 
TRUE); 
 
ChangeWindowFontDPI(hWnd, _this->m_newDPI); 
return TRUE; 
} 
return FALSE; 
} 
 
void CMainDialog::OnSize(UINT nType, int cx, int cy) 
{ 
CDialog::OnSize(nType, cx, cy); 
 
// Get the new DPI and enumerate the child windows that will use that value. 
m_currentDPI = ::GetDpiForWindow(this->GetSafeHwnd()); 
::EnumChildWindows(this->GetSafeHwnd(), EnumChildProc, (LPARAM)this); 
} 

Элементы ActiveX без окон

Для элементов ActiveX без окон не гарантировано наличие свойства HWND. Когда элемент ActiveX добавляется на холст документа, он переводится в режим конструктора. В приложениях Office контейнер размещения возвращает 0 для вызова hDC-GetWindow>() в событии ::OnDraw, когда элемент управления находится в режиме конструктора. В этом случае нельзя получить надежное значение разрешения.

Однако если элемент управления находится в режиме выполнения, Office вернет свойство HWND, где должен отображаться элемент управления. В этом случае разработчик элемента управления может вызвать функцию GetDpiForWindow и получить текущее разрешение, а также шрифты масштабирования, элементы управления и т. д.

Возможности расширения настраиваемой ленты

Любые обратные вызовы из Office для элементов управления настраиваемой ленты будут выполняться в потоке с поддержкой определения DPI на уровне системы. Если решение ожидает другой режим поддержки определения DPI потока, следует внедрить контекстный блок, чтобы установить нужный режим поддержки определения для потока. Дополнительные сведения см. в разделе Создание контекстного блока.

OLE-серверы и клиенты

Если OLE-сервер размещен в контейнере OLE клиента, в настоящее время нельзя предоставить сведения о текущем или поддерживаемом разрешении. Это может привести к проблемам, так как некоторые сочетания родительского и дочернего окон с разными режимами не поддерживаются в текущей архитектуре Windows.

До Office 365 версии 2109 для Excel и PowerPoint и версии 2203 для Word

Если Excel, PowerPoint или Word обнаружить наличие нескольких мониторов с разными масштабами DPI, они не будут поддерживать активацию на месте. Активация OLE-сервера выполняется "не на месте". Если возникают проблемы при взаимодействии с OLE-сервером, пользователю потребуется использовать Режим совместимости разрешений в Office.

После Office 365 версии 2109 для Excel и PowerPoint и версии 2203 для Word

Начиная с версии 2109 для Excel и PowerPoint и версии 2203 для Word все три приложения разрешают активацию на месте в режимах с поддержкой DPI для каждого монитора при выполнении определенных условий. При активации на месте в качестве OLE-серверов приложения Office будут проверка DPI_AWARENESS_CONTEXT родительского окна, предоставленного контейнером, и разрешают активацию на месте в зависимости от того, какой из следующих режимов отображения DPI Office выбран пользователем:

• "Оптимизировать для оптимального внешнего вида" позволит активировать на месте, если окно, предоставляемое контейнером, имеет значение На монитор DPI с учетом (DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE или DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2).
• "Оптимизация для совместимости" позволит активировать на месте, если окно, предоставляемое контейнером, имеет значение System DPI Aware (DPI_AWARENESS_CONTEXT_SYSTEM_AWARE), а приложение контейнера и приложение Office имеют одинаковые системные DPI.

Эта проверка совместимости контекста DPI означает, что контейнеры OLE не в курсе DPI не смогут активировать ни одно из приложений на месте. Решение заключается в том, чтобы изменить уровень доступности DPI приложения-контейнера на System DPI Aware (и использовать параметр "Оптимизировать для совместимости" в приложении Office). Это можно сделать с помощью SetProcessDpiAwareness, встроенного или внешнего манифеста. Внешний манифест особенно полезен для существующих решений VB Forms, так как он не требует повторной компиляции решения.

При использовании в качестве контейнера OLE и Excel, и PowerPoint откладывают на сервер для проверка совместимости с пониманием DPI, и они не препятствуют активации на месте.

Веб-надстройки Office

Веб-надстройки Office созданные с помощью API JavaScript для Office, запускаются внутри элемента управления браузера. Обрабатывать масштабирование можно с помощью тех же методов, которые используются при разработке любого веб-приложения. Существует много сетевых ресурсов, помогающих разработать веб-страницу для экранов с высоким разрешением.

Проверка того, что решение поддерживает масштабирование

После обновления приложения для поддержки масштабирования необходимо проверить изменения в среде с разными разрешениями. Убедитесь, что ваш код пользовательского интерфейса правильно реагирует на изменения разрешения, когда окно решения перемещается между дисплеями с разными значениями разрешений. Дополнительные сведения о методах проверки масштабирования см. в статье Разработка классических приложений с высоким разрешением для Windows.

Вы также могут пригодиться эти дополнительные методы:

• При использовании ноутбука можно установить основной монитор на внешнем мониторе, затем отсоединить ноутбук. Это приведет к принудительному переключению основного монитора на дисплей ноутбука.
• Используйте средство WinSpy ++ с открытым кодом для помощи в отладке. Его можно использовать для просмотра настройки поддержки определения DPI любого окна.
• Также можно использовать удаленный рабочий стол, чтобы протестировать использование нескольких мониторов на удаленном компьютере, выбрав пункт "Использовать все мои мониторы для удаленного сеанса" на вкладке "Экран", как показано на снимке экрана ниже.

См. также

Статьи

• Разработка Per-Monitor DPI-Aware приложения WPF предоставляет общий обзор и руководство по написанию классических приложений Win32. Многие из методов, описанных в этой статье применяются для решений по расширению Office.
• API для смешанного использования режимов масштабирования и поддержки определения DPI. Содержит список API, относящихся к разрешению.
• Руководство разработчика. Разрешение на каждый монитор содержит руководство по разработке приложений WPF для создания приложений WPF с поддержкой DPI.
• Поддержка мониторов с высоким разрешением в Office. Содержит сведения о том, как пользователь может настроить Office для оптимизации обеспечения совместимости, если решение для Office не поддерживается надлежащим образом при изменении разрешения.
• Изменение масштаба экрана для юбилейного обновления Windows 10. Это запись блога, описывающая изменения, которые добавлены в юбилейном обновлении Windows 10.
• Маркер DPI_AWARENESS_CONTEXT. Содержит сведения о значениях и определениях DPI_AWARENESS_CONTEXT для программирования.
• Разработка классических приложений с высоким разрешением для Windows. Содержит сведения о тестировании в разделе "Тестирование изменений".

Примеры кода

• Пример поддержки определения DPI на уровне окна
• Пример динамического разрешения
• Пример WPF c поддержкой определения на уровне монитора