Office ソリューションで高 DPI と DPI スケーリングを処理します

今では多くのコンピューターとディスプレイの構成が高 DPI (1 インチあたりのドット数) の解像度に対応しており、サイズやピクセル密度の異なる複数のモニターを接続することができます。 ここでは、ユーザーがアプリを異なる DPI のモニターに移動したとき、またはズーム レベルを変更したときに、アプリケーションを調整する必要があります。 DPI スケーリングをサポートしていないアプリケーションは、低 DPI のモニターでは正常に見えるかもしれませんが、高 DPI のモニター上に表示すると、伸縮され、ぼやけて見えます。

Word や Excel などの Office 2016 アプリケーションは、倍率の変更に応答できるように更新されました。 ただし、DPI が変更されたときに正しく表示するには、ご自身の Office ソリューションも変更に応答する必要があります。 この記事では、Office での動的 DPI サポートのしくみと、ご自身の Office 機能拡張ソリューションで、DPI スケーリングを処理して最適な表示エクスペリエンスを実現するために実行できる手順について説明します。

DPI スケーリングによってソリューションに生じる現象

Windows では、アプリケーションが 1 つのディスプレイから DPI の異なる別のディスプレイに移動されたときに、DPI スケーリングが適用されます。 これは、アプリケーションを別のモニターにドラッグした場合や、ノート PC をドッキングした場合などに発生します。 Office ソリューションが DPI スケーリングによって悪影響を受けた場合は、次の 1 つまたは複数の現象が見られます。

• ウィンドウが間違った位置に表示される、または間違った大きさで表示される。
• ボタンやラベルなどの要素がソリューションのウィンドウの間違った位置に表示される。
• フォントと画像が小さすぎる、大きすぎる、または間違った位置に表示される。

次の種類の Office ソリューションは、DPI スケーリングの影響を受ける可能性があります。

• VSTO アドイン
• カスタム作業ウィンドウ
• COM アドイン
• ActiveX コントロール
• リボンの拡張機能
• OLE サーバー
• Office Web アドイン

Windows DPI 対応モード

この記事全体を通して、Windows でサポートされている DPI 対応モードを記載しています。 次の表に示すように、DPI 対応モードによってサポートされる機能が異なります。 これは、Office ソリューションでそれらのモードがどのようにサポートされているかを示すための、モードに関する簡略化した説明です。 DPI 対応モードの詳細については、「High DPI Desktop Application Development on Windows」 (Windows での高 DPI デスクトップ アプリケーション開発) を参照してください。

モード	説明	DPI が変更されたとき
DPI 非対応	常に、DPI 値 96 のディスプレイ上に表示すると仮定してアプリケーションを表示します。	プライマリ ディスプレイとセカンダリ ディスプレイ上で想定されているサイズまでアプリケーションをビットマップ伸縮します。
システム DPI 対応	Windows へのログイン時に、接続されているプライマリ モニターの DPI をアプリケーションで検出しますが、DPI の変更に応答することはできません。 詳細については、この記事の「 ぼやけたアプリを修正するように Windows を構成する 」セクションを参照してください。	DPI の異なる新しいディスプレイに移動したときにアプリケーションをビットマップ伸縮します。
モニターごとの DPI 対応	DPI が変更されたときにアプリケーションを正しく再表示できます。	Windows からアプリケーションのトップレベル ウィンドウに DPI 通知が送信され、DPI が変更されたときにアプリケーションを再表示できます。
モニターごと (v2)	DPI が変更されたときにアプリケーションを正しく再表示できます。	Windows からトップレベル ウィンドウと子ウィンドウの両方に DPI 通知が送信され、DPI が変更されたときにアプリケーションを再表示できます。

Office で DPI スケーリングがサポートされるしくみ

ご自身の Office ソリューションが DPI スケーリングをどのように処理できるかを判断する際に最も重要な考慮事項は、ソリューションがトップレベル ウィンドウであるか、子ウィンドウであるかということです。 次の図は、トップレベル ウィンドウまたは子ウィンドウとして実行されている Office ソリューションのいくつかの例と、それらのソリューションによって Windows April 2018 Update (1803) 以降で使用される DPI 対応モードを示しています。

この画像では:

• 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 アプリケーションの開始時に、DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE として SetThreadDpiAwarenessContext への呼び出しが行われます。 このコンテキストでは、DPI の変更が、モニターごとの DPI 対応として実行されているトップレベル ウィンドウの HWND に送信されます。 トップレベル ウィンドウとは、Office アプリケーション ウィンドウと、ご自身のソリューションによって作成される追加のトップレベル ウィンドウのことです。 Office アプリケーションは、新しいディスプレイに移動されると通知を受け取ります。これにより、動的に拡大縮小して新しいディスプレイの DPI で正しく表示できるようになります。 ご自身の Office ソリューションでは、任意の DPI 対応モードのトップレベル ウィンドウを作成できます。 変更に関する Windows メッセージをリッスンすることによって、トップレベル ウィンドウでも DPI の変更に応答することができます。

トップレベル ウィンドウを親とする子ウィンドウを作成した場合、子ウィンドウを任意の DPI 対応モードに設定できます。 ただし、モニターごとの DPI 対応モードを使用する場合、子ウィンドウは DPI 変更通知を受け取りません。 Windows DPI 対応モードの詳細については、「High DPI Desktop Application Development on Windows」 (Windows での高 DPI デスクトップ アプリケーション開発) を参照してください。

子ウィンドウ管理

ActiveX コントロールとカスタム作業ウィンドウを使用していると、Office によってご自身のソリューションの子ウィンドウが作成されます。 追加の子ウィンドウを作成できますが、親ウィンドウの DPI 対応について知っておく必要があります。 Office はモニターごとの DPI 対応モードで実行されます。つまり、ご自身のソリューションのどの子ウィンドウも、DPI 変更通知を受け取りません。 DPI 変更の子ウィンドウへの送信をサポートしているのは、モニターごと (v2) モードのみです (Office はモニターごと (v2) をサポートしていません)。 ただし、ActiveX コントロールについては、回避策があります。 詳細については、このトピックで後述する「ActiveX コントロール」セクションを参照してください。

注:

子ウィンドウでトップレベル ウィンドウを作成する場合、新しいトップレベル ウィンドウには任意の DPI 対応モードを使用できます。 トップレベル ウィンドウの管理の詳細については、この記事の「トップレベル ウィンドウ管理」セクションを参照してください。

実行されている Windows 10 の Office のバージョンに応じて、子ウィンドウの表示に 2 つの異なる DPI モードが適用されます。

Windows Fall Creators Update (1709) での Office DPI の動作

Office アプリではモニターごとの対応モードが使用されるため、ご自身のソリューションの子ウィンドウも、モニターごとの DPI 対応モードで作成されます。 つまり、Windows では、新しい DPI で表示するときに、ソリューションを更新する必要があります。 ウィンドウは DPI 変更通知を受け取ることができないため、ソリューションの UI は正しくなくなる可能性があります。

Windows April 2018 Update (1803) での Office の DPI 動作

Windows April 2018 (1803) Update 以降では、一部のシナリオについて、Office DPI ホスティング動作に混在モードの DPI スケーリングが使用されます。 これにより、Office ウィンドウを親とするシステム DPI 対応ウィンドウは、モニターごとの DPI 対応に設定されます。 これは、ウィンドウがビットマップ伸縮されたときに DPI が変更される場合の互換性向上に役立ちます。 それでもウィンドウはビットマップ伸縮によってぼやける可能性があります。

新しい子ウィンドウを作成するときは、親ウィンドウの DPI 対応と一致していることを確認してください。 GetWindowDpiAwarenessContext 関数を使用して、親ウィンドウの DPI 認識を取得できます。 DPI 対応の一貫性の詳細については、「High DPI Desktop Application Development on Windows」 (Windows での高 DPI デスクトップ アプリケーション開発) の「Forced reset of process-wide DPI awareness」 (プロセス全体で DPI 対応を強制的に再設定する) セクションを参照してください。

注:

プロセスの DPI 対応は、アプリケーションのメイン スレッドの DPI 対応コンテキストが DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE であったとしても PROCESS_SYSTEM_DPI_AWARE を返す可能性があるため、プロセスの DPI 対応を利用することはできません。 スレッドの DPI 対応コンテキストを取得するには、GetThreadDpiAwarenessContext 関数を使用します。

Office と Windows の DPI の互換性設定

アドインまたはソリューションが正しく表示されない場合、いくつかの互換性設定が問題の修正に役立つことがあります。

互換性を最適化するための Office の構成

Office には、異なる画面上の異なる DPI スケールに移動したときの互換性を最適化する設定があります。 互換モードでは、DPI スケーリングを無効にすることで、異なる DPI スケーリングを使用しているディスプレイに移動したときに、Office のあらゆる内容がビットマップ伸縮されるようになります。

互換モードでは、Office を強制的にシステム DPI 対応モードで実行します。 これにより、アプリケーション ウィンドウがビットマップ伸縮され、表示がぼやけるという影響が出ることがあります。 この設定はユーザーが選択するため、ご自身の Office ソリューションではこの設定を制御できません。 ディスプレイの互換モードを使用すると、ほとんどの表示の問題が解決されます。 詳細については、「Office による高解像度ディスプレイのサポート」を参照してください。

ぼやけた状態のアプリを修正するための Windows の構成

Windows 10 (Version 1803) 以降には、アプリのぼやけた状態を修正する設定があります。 これは、ご自身のソリューションが正しく表示されない場合に試すもう 1 つの設定です。 この設定はユーザーが選択するため、ご自身の Office ソリューションではこの設定を制御できません。 詳細については、「Windows 10 でぼやけて表示されるアプリを修正する」を参照してください。

ソリューションで DPI スケーリングをサポートする方法

一部のソリューションでは、DPI の変更情報を受け取り、応答することができます。 一部には、通知を受け取ることができない場合の回避策があります。 次の表は、各ソリューションの種類の詳細を示しています。

ソリューションの種類	ウィンドウの種類	DPI スケーリングに応答できる	詳細情報
VSTO アドイン	トップとその子孫	はい	「VSTO アドインのガイダンス」を参照してください。
	Office ウィンドウを親とする子	いいえ	「互換性を最適化するための Office の構成」を参照してください。
カスタム作業ウィンドウ	トップとその子孫	はい	「トップレベル ウィンドウのガイダンス」を参照してください。
	Office ウィンドウを親とする子	いいえ	「互換性を最適化するための Office の構成」を参照してください。
COM アドイン	トップとその子孫	はい	「COM アドインのガイダンス」を参照してください。
	Office ウィンドウを親とする子	いいえ	「互換性を最適化するための Office の構成」を参照してください。
ActiveX コントロール	トップとその子孫	はい	「ActiveX コントロールのガイダンス」を参照してください。
	Office ウィンドウを親とする子	はい
Web アドイン	該当なし	はい	「Office Web アドインのガイダンス」を参照してください。
リボンの拡張機能	該当なし	該当なし	「リボンの拡張機能のガイダンス」を参照してください。
OLE サーバーまたはクライアント	該当なし	該当なし	「OLE サーバー/クライアントのガイダンス」を参照してください。

VSTO アドイン

ご自身の VSTO アドインで Office ウィンドウを親とする子ウィンドウを作成する場合、親ウィンドウの DPI 対応と一致していることを確認してください。 GetWindowdpiAwarenessContext 関数を使用して、親ウィンドウの DPI 対応を取得できます。 子ウィンドウは DPI 変更通知を受け取りません。 ソリューションが正しく表示されない場合、ユーザーが Office を互換モードにする必要があります。

ご自身の VSTO アドインで作成するすべてのトップレベル ウィンドウについて、任意の DPI 対応モードを設定できます。 次のサンプル コードでは、目的の DPI 対応を設定する方法と、DPI の変更に応答する方法を示しています。 「Windows フォームでの高 DPI サポート」の記事にある説明に従って、使用する app.config を調整することも必要です。

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) で実行する場合、カスタム作業ウィンドウは、Office と同じ DPI 対応モードを使用して実行されます。 Windows April 2018 Update (1803) 以降で実行する場合、カスタム作業ウィンドウはシステム DPI 対応モードを使用して実行されます。

カスタム作業ウィンドウは子ウィンドウであるため、DPI 通知を受け取ることはできません。 それらの表示が正しく行われない場合、ユーザーは Office DPI 互換モードを使用する必要があります。 ご自身のカスタム作業ウィンドウでトップレベル ウィンドウを作成した場合、それらのウィンドウはどの DPI 対応モードでも実行でき、DPI 変更通知を受け取ることがことができます。 詳細については、この記事の「トップレベル ウィンドウ管理」セクションを参照してください。

COM アドイン

トップレベル ウィンドウを作成する COM アドインは、DPI 通知を受け取ることができます。 ウィンドウに必要な DPI 対応をスレッドに対して設定するには、コンテキスト ブロックを作成してから、ウィンドウを作成する必要があります。 DPI 通知を正しく処理するには多くの知識が必要であるため、詳細については、「High DPI Desktop Application Development on Windows」 (Windows での高 DPI デスクトップ アプリケーション開発) を参照してください。

ウィンドウの DPI が変更されると、WM_DPICHANGED というメッセージが送信されます。 アンマネージド コードでは、このメッセージは HWND のウィンドウ プロシージャによって処理されます。 WM_DPICHANGED の記事に DPI 変更ハンドラー コードのサンプルがあります。

Office 内のウィンドウを親とする子ウィンドウを表示する COM アドインは、DPI 通知を受け取ることはできません。 それらの表示が正しく行われない場合、ユーザーは Office DPI 互換モードを使用する必要があります。

ActiveX コントロール

ActiveX コントロールにおいて DPI スケーリングをサポートする方法は、そのコントロールがウィンドウ付きかウィンドウなしかによって異なります。

ウィンドウ付きの ActiveX コントロール

ウィンドウ付きの ActiveX コントロールは、コントロールのサイズが変更されるたびに WM_SIZE メッセージを受け取ります。 このイベントがトリガーされたら、イベント ハンドラー コードからコントロールの HWND を使って GetDpiForWindow 関数を呼び出して DPI を取得し、倍率の違いを計算して、必要に応じて調整することができます。

次の例では、OnSize イベントに応答する MFC ベースの ActiveX コントロールを有効にしています。

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 アプリケーションでは、コントロールがデザイン モードのときに::OnDraw イベントの hDC-GetWindow>() の呼び出しに対して、ホスティング コンテナーから 0 が返されます。 この場合、信頼性の高い DPI を取得することはできません。

ただし、コントロールがランタイム モードのときは、コントロールを表示する位置の HWND が Office から返されます。 この場合、コントロールの開発者は GetDpiForWindow を呼び出して現在の DPI を取得し、フォントやコントロールなどを拡大縮小することができます。

カスタム リボンの機能拡張

カスタム リボン コントロールに対する Office からのコールバックは、システム DPI 対応の DPI スレッド対応になります。 ご自身のソリューションで異なる DPI スレッド対応が必要な場合は、正常なスレッド対応を設定するように、コンテキスト ブロックを実装する必要があります。 詳細については、「コンテキスト ブロックの作成」を参照してください。

OLE クライアントとサーバー

OLE サーバーが OLE クライアント コンテナー内でホストされている場合、現時点では、現在の DPI 情報またはサポートされている DPI 情報を提供することはできません。 これを行うと、問題が発生する可能性があります。親と子のウィンドウ混在モードの一部の組み合わせは、現在の Windows アーキテクチャでサポートされていないことが原因です。

バージョン 2109 for Excel と PowerPoint をOffice 365する前、バージョン 2203 for Word

Excel、PowerPoint、またはWord、DPI スケールが異なる複数のモニターがあることを検出した場合、インプレース アクティブ化はサポートされません。 使用する OLE サーバーは所定の場所以外でアクティブ化されます。 OLE サーバー間の対話に問題がある場合、ユーザーは Office DPI 互換モードを使用する必要があります。

バージョン 2109 Office 365 Excel と PowerPoint の後、バージョン 2203 for Word

Excel と PowerPoint のバージョン 2109、Wordのバージョン 2203 以降では、3 つのアプリケーションすべてで、特定の条件が満たされたときにモニターごとの DPI 対応モードでインプレース アクティブ化が可能になります。 OLE サーバーとしてインプレース アクティブ化すると、Office アプリケーションはコンテナーによって提供される親ウィンドウの をDPI_AWARENESS_CONTEXTチェックし、ユーザーが選択した次の Office DPI 表示モードに応じてインプレース アクティブ化を許可します。

• "最適な外観を得るための最適化" では、コンテナーによって提供されるウィンドウがモニター 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 認識コンテキストの互換性チェックは、DPI Unaware OLE コンテナーがどちらのアプリもインプレース アクティブ化できないことを意味します。 回避策は、コンテナー アプリの DPI 認識をシステム DPI 対応に変更することです (また、Office アプリの [互換性の最適化] 設定を使用します)。 これは、 SetProcessDpiAwareness、 埋め込みマニフェスト、または外部マニフェストを使用して実行できます。 外部マニフェストは、ソリューションを再コンパイルする必要がないため、既存の VB Forms ソリューションに特に役立ちます。

OLE コンテナーとして機能する場合、Excel と PowerPoint の両方がサーバーに遅延して DPI 認識の互換性をチェックし、インプレース アクティブ化を妨げるものではありません。

Office Web アドイン

Office JavaScript API を使用して作成された Office アドインは、ブラウザー コントロールの内部で実行されます。 Web アプリ デザインで使用するのと同じ方法を使って、DPI スケーリングを処理できます。 高解像度の画面向けの Web ページをデザインする際に役立つ多くのオンライン リソースを利用できます。

ソリューションが DPI スケーリングをサポートしていることの確認

DPI スケーリングをサポートするようにアプリケーションを更新した後、DPI 混在環境で変更を検証する必要があります。 ご自身のソリューションのウィンドウを、あるディスプレイから DPI 値が異なる別のディスプレイに移動したときに、DPI の変更に対して UI コードが正しく応答することを検証します。 DPI スケーリングのテスト方法の詳細については、「High DPI Desktop Application Development on Windows」 (Windows での高 DPI デスクトップ アプリケーション開発) を参照してください。

次に示すその他の方法も役に立つことがあります。

• ノート PC では、プライマリ モニターを外部モニターに設定してから、ノート PC のドッキングを解除できます。 これで、プライマリ モニターが強制的にノート PC のディスプレイに変更されます。
• デバッグに役立つオープン ソースの WinSpy++ ツールを使用します。 これを使用して、任意のウィンドウの DPI 対応の設定を確認できます。
• リモート デスクトップを使用して、リモート コンピューターの複数のモニターをテストすることができます。そうするには、次のスクリーンショットに示すように、[画面] タブで [リモート セッションですべてのモニターを使用する] をオンにします。

関連項目

記事

• Per-Monitor DPI-Aware WPF アプリケーションの開発 には、Win32 デスクトップ アプリケーションを記述するための一般的な概要とガイドが用意されています。 この記事で説明されているのと同じ方法の多くは、Office 機能拡張ソリューションにも適用されます。
• 「Mixed-Mode DPI Scaling and DPI-aware APIs」 (混在モードの DPI スケーリングと DPI 対応 API) には、DPI に関連した API の一覧が記載されています。
• 開発者ガイド - モニターごとの DPI には、DPI 対応 WPF アプリをビルドするための WPF アプリ開発ガイドが含まれます。
• 「Office による高解像度ディスプレイのサポート」では、DPI が変更されたときに Office ソリューションが適切にサポートされない場合に、ユーザーが互換性を最適化するように Office を設定する方法に関する情報を提供します。
• 「Display Scaling changes for the Windows 10 Anniversary Update」 (Windows 10 Anniversary Update でのディスプレイのスケーリングの変更) では、Windows 10 Anniversary Update で導入された変更について解説したブログ記事です。
• 「DPI_AWARENESS_CONTEXT handle」 (DPI_AWARENESS_CONTEXT ハンドル) には、DPI_AWARENESS_CONTEXT の値と定義に関するプログラミングの詳細が記載されています。
• 「High DPI Desktop Application Development on Windows」 (Windows での高 DPI デスクトップ アプリケーション開発) の「Testing Your Changes」 (変更のテスト) セクションには、テストに関する情報が記載されています。

コード サンプル

• ウィンドウごとの DPI 対応のサンプル
• 動的 DPI のサンプル
• モニターごとの対応の WPF のサンプル