フォントコントロール

[アーティクル]
08/19/2023

Windows リボンフレームワークは、ワープロ機能とテキスト編集機能を必要とするアプリケーションでのフォントサポートの統合と構成を簡略化するために、書体名、スタイル、ポイントサイズ、効果など、さまざまなフォントプロパティを公開する特殊なフォントコントロールを提供します。

はじめに
一貫性のあるエクスペリエンス
簡単な統合と構成
一般的な GDI テキスト構造との配置
FontControl を追加する
- マークアップでの FontControl の宣言
- フォントコントロールのプロパティ
FontControl コマンドハンドラーを定義する
関連トピック

はじめに

フォントコントロールは、ボタン、トグルボタン、ドロップダウンリストボックス、コンボボックスで構成される複合コントロールです。これらはすべて、特定のフォントプロパティまたは書式設定オプションを指定するために使用されます。

次のスクリーンショットは、Windows 7 用ワードパッドのリボンフォントコントロールを示しています。

richfont 属性が true に設定されている fontcontrol 要素のスクリーンショット。

一貫性のあるエクスペリエンス

組み込みのリボンコントロールとして、フォントコントロールは全体的なフォント管理、選択、書式設定機能を向上させ、すべてのリボンアプリケーションで一貫性のある豊富なユーザーエクスペリエンスを提供します。

この一貫性のあるエクスペリエンスには、次のものが含まれます。

リボンアプリケーション全体でのフォントの標準化された書式設定と選択。
リボンアプリケーション全体で標準化されたフォント表現。
Windows 7 では、[フォント] コントロールパネルの各フォントの [表示] または [非表示] 設定に基づくフォントのアクティブ化が自動的に行われます。 [フォントコントロール] には、[ 表示] に設定されているフォントのみが表示されます。

注意

Windows Vista では、[ フォント ] コントロールパネルには [表示 ] または [ 非表示] 機能がないため、すべてのフォントがアクティブになります。
コントロールから直接使用できるフォント管理。

次のスクリーンショットは、[フォント] コントロールパネルに [ フォント コントロール] から直接アクセスできることを示しています。
自動プレビューのサポート。
ユーザーに最も関連性の高いフォント (例:
- 国際ユーザー向けのローカライズされたフォントリスト。
- 入力デバイスに基づくフォントリスト。
注意

この機能のサポートは、Windows 7 より古いプラットフォームでは使用できません。

簡単な統合と構成

リボンフォントコントロールは、標準的で再利用可能で使いやすい機能を提供することで、フォントサポートをアプリケーションに統合する負担を軽減します。

フォントの選択と書式設定の詳細は、1 つの自己完結型論理要素にラップされます。

フォントコントロールの実装に典型的なコントロール相互依存の複雑な管理を排除します。
Font Control サブコントロールによって公開されるすべての機能に対して、1 つの Command ハンドラーが必要です。

この 1 つのコマンドハンドラーを使用すると、フォントコントロールは、さまざまなサブコントロールの機能を内部的に管理できます。サブコントロールは、その関数に関係なく、アプリケーションと直接対話することはありません。

フォントコントロールのその他の機能は次のとおりです。

[ フォントファミリ ] メニューの各フォントの WYSIWYG (表示される内容) ビットマップ表現の DPI 対応の自動生成。
Windows グラフィックスデバイスインターフェイス (GDI) の統合。
ローカライズされたフォントファミリのビットマップとヒント。
フォントを管理および表示するためのフォント列挙、グループ化、およびメタデータ。

注意

この機能のサポートは、Windows 7 より古いプラットフォームでは使用できません。
[テキストの色] と [テキストの強調表示] の [色] ドロップダウンの色選択ウィンドウで、リボンのドロップダウンカラーピッカーの動作をミラーします。
フォントファミリ、フォント サイズ、テキストの色、テキストの強調表示の色など、すべてのフォント コントロールギャラリーベースのサブコントロールによる自動プレビューのサポート。

一般的な GDI テキスト構造との配置

Windows グラフィックスデバイスインターフェイス (GDI) テキストスタックコンポーネントは、リボンのフォントコントロールを使用してフォントの選択と書式設定機能を公開するために使用されます。 LOGFONT 構造体、CHOOSEFONT 構造体、および CHARFORMAT2 構造体でサポートされているさまざまなフォント機能は、フォントコントロールに含まれるサブコントロールを介して公開されます。

フォントコントロールに表示されるサブコントロールは、リボンマークアップで宣言されている FontType テンプレートによって異なります。 FontType テンプレート (以降のセクションで詳しく説明します) は、一般的な Windows グラフィックスデバイスインターフェイス (GDI) テキスト構造に合わせて設計されています。

FontControl を追加する

このセクションでは、リボンアプリケーションにフォントコントロールを追加するための基本的な手順について説明します。

マークアップでの FontControl の宣言

他のリボンコントロールと同様に、Font Control は FontControl 要素を使用してマークアップで宣言され、Command ID を介して Command 宣言に関連付けられます。アプリケーションがコンパイルされると、コマンド ID を使用して、ホストアプリケーションの Command ハンドラーに Command がバインドされます。

注意

マークアップで FontControl を使用してコマンド ID が宣言されていない場合は、フレームワークによって生成されます。

フォントコントロールのサブコントロールは直接公開されないため、フォントコントロールのカスタマイズは、フレームワークによって定義された 3 つの FontType レイアウトテンプレートに制限されます。

フォントコントロールをさらにカスタマイズするには、レイアウトテンプレートと、IsHighlightButtonVisible、IsStrikethroughButtonVisible、IsUnderlineButtonVisible などの FontControl 属性を組み合わせて使用できます。

注意

標準のフォントコントロールテンプレートと属性によって公開される以外のフォント機能には、この記事の範囲外のカスタムフォントコントロールの実装が必要です。

次の表に、フォントコントロールテンプレートと、各テンプレートが配置されている編集コントロールの種類を示します。

Template	サポート
FontOnly	LOGFONT 構造体
FontWithColor	CHOOSEFONT 構造体
RichFont	CHARFORMAT2 構造体

次の表に、各テンプレートに関連付けられているコントロールの一覧を示し、関連付けられたテンプレートに対して省略可能なコントロールを示します。

コントロール

テンプレート

RichFont

FontWithColor

FontOnly

Default

省略可能

Default

省略可能

Default

Optional

[フォントサイズ ] コンボボックス

○

いいえ

○

いいえ

○

いいえ

[フォントファミリ ] コンボボックス

○

いいえ

○

いいえ

○

いいえ

[フォントの拡大 ] ボタン

○

はい

[フォントの縮小 ] ボタン

はい

○

太字ボタン

○

いいえ

はい

いいえ

○

いいえ

斜体ボタン

○

いいえ

○

いいえ

○

いいえ

下線ボタン

○

いいえ

○

はい

取り消し線 ボタン

○

いいえ

○

はい

○

下付き文字 ボタン

はい

いいえ

上付きボタン

○

いいえ

[テキストの強調表示の色 ] ボタン

○

いいえ

○

[テキストの色] ボタン

○

いいえ

○

いいえ

フォントコントロールのレイアウト動作が宣言されている場合、リボンフレームワークにはオプションの SizeDefinition レイアウトテンプレートが用意されています。このテンプレートでは、 OneFontControlリボンのサイズとフォントコントロールで使用できる領域に基づいて 2 つのサブコントロール構成が定義されます。詳細については、「サイズ定義とスケーリングポリシーによるリボンのカスタマイズ」を参照してください。

リボンへの FontControl の追加

次のコード例は、リボンにフォントコントロールを追加するための基本的なマークアップ要件を示しています。

このコードセクションでは、リボンにコントロールを表示するために必要な Tab コマンドやグループ コマンドなど、FontControl コマンド宣言マークアップを示します。

<Command Name="cmdTab1"
  Comment="These comments are optional and are inserted into the header file."
  Symbol="cmdTab1" Id="10000" >
  <Command.LabelTitle>Tab 1</Command.LabelTitle>
</Command>
<Command Name="cmdGroup1" Comment="Group #1" Symbol="cmdGroup1" Id="20000">
  <!-- This image is used when the group scales to a pop-up. -->
  <Command.SmallImages>
    <Image>res/Button_Image.bmp</Image>
  </Command.SmallImages>
</Command>
<Command Name="cmdFontControl" Symbol="cmdFontControl" Comment="FontControl" Id="25001" Keytip="F" />

コードのこのセクションでは、Command ID を使用して FontControl を宣言して コマンド に関連付けるために必要なマークアップを示します。この特定の例には、タブ宣言と グループ 宣言とスケーリング設定が含まれます。

<Ribbon.Tabs>
  <Tab CommandName="cmdTab1">
    <Tab.ScalingPolicy>
      <ScalingPolicy>
        <ScalingPolicy.IdealSizes>
          <Scale Group="cmdGroup1" Size="Large" />
        </ScalingPolicy.IdealSizes>
        <!-- Describe how the FontControl group scales. -->
        <Scale Group="cmdGroup1" Size="Medium" />
        <Scale Group="cmdGroup1" Size="Popup" />
      </ScalingPolicy>
    <Group CommandName="cmdGroup1" SizeDefinition="OneFontControl">
      <FontControl CommandName="cmdFontControl" FontType="RichFont" />
    </Group>
  </Tab>
</Ribbon.Tabs>

ContextPopup への FontControl の追加

コンテキストポップアップにフォントコントロールを追加するには、リボンにフォントコントロールを追加する手順と同様の手順が必要です。ただし、 MiniToolbar のフォントコントロールは、すべてのフォントコントロールテンプレートに共通する既定のサブコントロールのセット ( フォントファミリ、 フォントサイズ、太字、斜体) に制限されます。

次のコード例は、コンテキストポップアップにフォントコントロールを追加するための基本的なマークアップ要件を示しています。

このコードセクションでは、ContextPopupで FontControl を表示するために必要な FontControl コマンド宣言マークアップを示します。

<Command Name="cmdFontControl" Symbol="cmdFontControl" Comment="FontControl" Id="25001" />

コードのこのセクションでは、Command ID を使用して FontControl を宣言してコマンドに関連付けるために必要なマークアップを示します。

<ContextPopup.MiniToolbars>
  <MiniToolBar Name="MiniToolbar1">
    <MenuCategory Class="StandardItems">
      <FontControl CommandName="cmdFontControl" />
    </MenuCategory>
  </MiniToolBar>
</ContextPopup.MiniToolbars>

Keytips

リボンフォントコントロールの各サブコントロールには、キーボードショートカットまたはキーヒントを使用してアクセスできます。このキーヒントは定義済みであり、フレームワークによって各サブコントロールに割り当てられます。

Keytip 属性値がマークアップの FontControl 要素に割り当てられている場合、この値はフレームワーク定義のキーヒントのプレフィックスとして追加されます。

注意

アプリケーションでは、このプレフィックスに 1 文字の規則を適用する必要があります。

次の表に、フレームワークで定義されているキーヒントの一覧を示します。

サブコントロール	Keytip
フォントファミリ	F
[フォントスタイル]	T
フォントサイズ	S
フォントを拡大する	G
フォントの縮小	K
太字	B
[斜体]	I
Underline	U
取り消し線	X
Superscript	Y または Z 注:Keytip 属性がマークアップで宣言されていない場合、既定のキーヒントは Y です。それ以外の場合、既定のキーヒントは Keytip + Z です。
Subscript	A
フォントの色	C
フォントの強調表示	H

次の例に示すように、多言語ユーザーインターフェイス (MUI) EN-US リボンの推奨されるプレフィックスは 'F' です。

<Command Name="cmdFontControl" Symbol="cmdFontControl" Comment="FontControl" Id="25001" Keytip="F" />

次のスクリーンショットは、前の例で定義したフォントコントロールキーヒントを示しています。

Windows 7 のワードパッドの fontcontrol キーヒントのスクリーンショット。

リボンリソースファイル

マークアップファイルがコンパイルされると、リボンアプリケーションのすべてのリソース参照を含むリソースファイルが生成されます。

単純なリソースファイルの例:

// ******************************************************************************
// * This is an automatically generated file containing the ribbon resource for *
// * your application.                                                          *
// ******************************************************************************

#include ".\ids.h"

STRINGTABLE 
BEGIN
  cmdTab1_LabelTitle_RESID L"Tab 1" 
    /* LabelTitle cmdTab1_LabelTitle_RESID: These comments are optional and are 
       inserted into the header file. */
END

cmdGroup1_SmallImages_RESID    BITMAP    "res\\Button_Image.bmp" 
  /* SmallImages cmdGroup1_SmallImages_RESID: Group #1 */
STRINGTABLE 
BEGIN
  cmdFontControl_Keytip_RESID L"F" /* Keytip cmdFontControl_Keytip_RESID: FontControl */
END

FCSAMPLE_RIBBON    UIFILE    "Debug\\FCSample.bml"

フォントコントロールのプロパティ

リボンフレームワークは、フォントコントロールとその構成要素のサブコントロールのプロパティキーのコレクションを定義します。

通常、Font Control プロパティは、 IUIFramework::InvalidateUICommand メソッドの呼び出しによってコントロールに関連付けられている Command を無効にすることで、リボン UI で更新されます。無効化イベントが処理され、 IUICommandHandler::UpdateProperty コールバックメソッドによって定義されたプロパティが更新されます。

IUICommandHandler::UpdateProperty コールバックメソッドは実行されず、アプリケーションは、フレームワークでプロパティが必要になるまで、更新されたプロパティ値を照会しました。たとえば、タブがアクティブ化され、リボン UI にコントロールが表示されたときや、ツールヒントが表示されたときなどです。

注意

場合によっては、 IUIFramework::GetUICommandProperty メソッドを使用してプロパティを取得し、 IUIFramework::SetUICommandProperty メソッドを使用して設定できます。

次の表に、フォントコントロールに関連付けられているプロパティキーの一覧を示します。

プロパティキー	Notes
UI_PKEY_FontProperties	IPropertyStore オブジェクトとして集計された、すべての Font Control サブコントロールプロパティを公開します。フレームワークは、IUIFramework::InvalidateUICommand の呼び出しでフラグの値としてが渡されたときに`UI_INVALIDATIONS_VALUE`、このプロパティを照会します。
UI_PKEY_FontProperties_ChangedProperties	IUISimplePropertySet オブジェクトとして集計で、変更された Font Control サブコントロールプロパティのみを公開します。
UI_PKEY_Keytip	無効化によってのみ更新できます。
UI_PKEY_Enabled	IUIFramework::GetUICommandProperty と IUIFramework::SetUICommandProperty をサポートします。

リボンフレームワークでは、フォントコントロール自体でサポートされるプロパティに加えて、各フォントコントロールサブコントロールのプロパティキーも定義します。これらのプロパティキーとその値は、名前と値のペアのプロパティバッグとも呼ばれるコレクションを管理するためのメソッドを定義する IPropertyStore インターフェイス実装を通じてフレームワークによって公開されます。

アプリケーションは、フォント構造を IPropertyStore インターフェイスメソッドを介してアクセスできるプロパティに変換します。このモデルでは、フレームワークでサポートされているフォントコントロールと Windows グラフィックスデバイスインターフェイス (GDI) テキストスタックコンポーネント (LOGFONT 構造体、 CHOOSEFONT 構造体、 CHARFORMAT2 構造体) の違いを強調しています。

次の表に、個々のコントロールとそれに関連付けられているプロパティキーの一覧を示します。

コントロール	プロパティキー	Notes
[フォントサイズ]	UI_PKEY_FontProperties_Size	異種サイズのテキストの実行が強調表示されている場合、リボンフレームワークは、フォントサイズコントロールを空白に設定し、 UI_PKEY_FontProperties_Size の値を 0 に設定します。 [ フォントの拡大 ] または [ フォントの縮小 ] ボタンをクリックすると、強調表示されているすべてのテキストのサイズが変更されますが、テキストサイズの相対的な違いは保持されます。
フォントファミリ	UI_PKEY_FontProperties_Family	GDI フォントファミリ名は、システムロケールによって異なります。そのため、 UI_PKEY_FontProperties_Family の値がアプリケーションセッション間で保持されている場合は、その値を新しいセッションごとに取得する必要があります。
フォントを拡大する	UI_PKEY_FontProperties_Size	「フォントサイズ」を参照してください。
フォントの縮小	UI_PKEY_FontProperties_Size	「フォントサイズ」を参照してください。
太字	UI_PKEY_FontProperties_Bold
斜体	UI_PKEY_FontProperties_Italic
下線	UI_PKEY_FontProperties_Underline
取り消し線	UI_PKEY_FontProperties_Strikethrough
Subscript	UI_PKEY_FontProperties_VerticalPositioning	[下付き文字] ボタンが設定されている場合、上付き文字も設定できません。
Superscript	UI_PKEY_FontProperties_VerticalPositioning	[上付き文字] ボタンが設定されている場合、下付き文字も設定できません。
テキストの強調表示の色	UI_PKEY_FontProperties_BackgroundColor、 UI_PKEY_FontProperties_BackgroundColorType	DropDownColorPicker 要素の`HighlightColors`テンプレートと同じ機能を提供します。アプリケーションでは、最初のテキスト強調表示の色の値のみを設定することを強くお勧めします。最後に選択した値は保持し、文書内でカーソルの位置を変更する場合は設定しないでください。これにより、ユーザーの最後の選択にすばやくアクセスでき、カラーピッカーを再度開く必要はありません。カラー見本はカスタマイズできません。
テキストの色	UI_PKEY_FontProperties_ForegroundColor、 UI_PKEY_FontProperties_ForegroundColorType	DropDownColorPicker 要素の`StandardColors`テンプレートと同じ機能を提供します。アプリケーションでは、初期のテキスト色の値のみを設定することを強くお勧めします。最後に選択した値は保持し、文書内でカーソルの位置を変更する場合は設定しないでください。これにより、ユーザーの最後の選択にすばやくアクセスでき、カラーピッカーを再度開く必要はありません。カラー見本はカスタマイズできません。

FontControl コマンドハンドラーを定義する

このセクションでは、フォントコントロールをコマンドハンドラーにバインドするために必要な手順について説明します。

警告

フォントコントロールのカラーピッカーからカラー見本を選択しようとすると、コントロールにコマンドハンドラーが関連付けられていない場合、アクセス違反が発生する可能性があります。

次のコード例では、マークアップで宣言されているコマンドを Command ハンドラーにバインドする方法を示します。

//
//  FUNCTION: OnCreateUICommand(UINT, UI_COMMANDTYPE, IUICommandHandler)
//
//  PURPOSE: Called by the Ribbon framework for each command specified in markup, to allow
//           the host application to bind a command handler to that command.
//
STDMETHODIMP CApplication::OnCreateUICommand(
  UINT nCmdID,
  __in UI_COMMANDTYPE typeID,
  __deref_out IUICommandHandler** ppCommandHandler)
{
  UNREFERENCED_PARAMETER(typeID);
  UNREFERENCED_PARAMETER(nCmdID);

  if (NULL == m_pCommandHandler)
  {
    HRESULT hr = CCommandHandler::CreateInstance(&m_pCommandHandler);
    if (FAILED(hr))
    {
      return hr;
    }
  }

  return m_pCommandHandler->QueryInterface(IID_PPV_ARGS(ppCommandHandler));
}

次のコード例は、フォントコントロールの IUICommandHandler::Execute メソッドを実装する方法を示しています。

//
//  FUNCTION: Execute()
//
//  PURPOSE: Called by the Ribbon framework when a command is executed 
//           by the user. For example, when a button is pressed.
//
STDMETHODIMP CCommandHandler::Execute(
  UINT nCmdID,
  UI_EXECUTIONVERB verb,
  __in_opt const PROPERTYKEY* key,
  __in_opt const PROPVARIANT* ppropvarValue,
  __in_opt IUISimplePropertySet* pCommandExecutionProperties)
{
  UNREFERENCED_PARAMETER(nCmdID);

  HRESULT hr = E_NOTIMPL;
  if ((key) && (*key == UI_PKEY_FontProperties))
  {
    // Font properties have changed.
    switch (verb)
    {
      case UI_EXECUTIONVERB_EXECUTE:
      {
        hr = E_POINTER;
        if (pCommandExecutionProperties != NULL)
        {
          // Get the changed properties.
          PROPVARIANT varChanges;
          hr = pCommandExecutionProperties->GetValue(UI_PKEY_FontProperties_ChangedProperties, &varChanges);
          if (SUCCEEDED(hr))
          {
            IPropertyStore *pChanges;
            hr = UIPropertyToInterface(UI_PKEY_FontProperties, varChanges, &pChanges);
            if (SUCCEEDED(hr))
            {
              // Using the changed properties, set the new font on the selection on RichEdit control.
              g_pFCSampleAppManager->SetValues(pChanges);
              pChanges->Release();
            }
            PropVariantClear(&varChanges);
          }
        }
        break;
      }
      case UI_EXECUTIONVERB_PREVIEW:
      {
        hr = E_POINTER;
        if (pCommandExecutionProperties != NULL)
        {
          // Get the changed properties for the preview event.
          PROPVARIANT varChanges;
          hr = pCommandExecutionProperties->GetValue(UI_PKEY_FontProperties_ChangedProperties, &varChanges);
          if (SUCCEEDED(hr))
          {
            IPropertyStore *pChanges;
            hr = UIPropertyToInterface(UI_PKEY_FontProperties, varChanges, &pChanges);
            if (SUCCEEDED(hr))
            {
              // Set the previewed values on the RichEdit control.
              g_pFCSampleAppManager->SetPreviewValues(pChanges);
              pChanges->Release();
            }
            PropVariantClear(&varChanges);
          }
        }
        break;
      }
      case UI_EXECUTIONVERB_CANCELPREVIEW:
      {
        hr = E_POINTER;
        if (ppropvarValue != NULL)
        {
          // Cancel the preview.
          IPropertyStore *pValues;
          hr = UIPropertyToInterface(UI_PKEY_FontProperties, *ppropvarValue, &pValues);
          if (SUCCEEDED(hr))
          {   
            g_pFCSampleAppManager->CancelPreview(pValues);
            pValues->Release();
          }
        }
        break;
      }
    }
  }

  return hr;
}

次のコード例は、フォントコントロールの IUICommandHandler::UpdateProperty メソッドを実装する方法を示しています。

//
//  FUNCTION: UpdateProperty()
//
//  PURPOSE: Called by the Ribbon framework when a command property (PKEY) needs to be updated.
//
//  COMMENTS:
//
//    This function is used to provide new command property values, such as labels, icons, or
//    tooltip information, when requested by the Ribbon framework.  
//    
//
STDMETHODIMP CCommandHandler::UpdateProperty(
  UINT nCmdID,
  __in REFPROPERTYKEY key,
  __in_opt const PROPVARIANT* ppropvarCurrentValue,
  __out PROPVARIANT* ppropvarNewValue)
{
  UNREFERENCED_PARAMETER(nCmdID);

  HRESULT hr = E_NOTIMPL;
  if (key == UI_PKEY_FontProperties)
  {
    hr = E_POINTER;
    if (ppropvarCurrentValue != NULL)
    {
      // Get the font values for the selected text in the font control.
      IPropertyStore *pValues;
      hr = UIPropertyToInterface(UI_PKEY_FontProperties, *ppropvarCurrentValue, &pValues);
      if (SUCCEEDED(hr))
      {
        g_pFCSampleAppManager->GetValues(pValues);

        // Provide the new values to the font control.
        hr = UIInitPropertyFromInterface(UI_PKEY_FontProperties, pValues, ppropvarNewValue);
        pValues->Release();
      }
    }
  }

  return hr;
}

Windows リボンフレームワークコントロールライブラリ
FontControl 要素
フォントコントロールのプロパティ
FontControl サンプル

フォントコントロール

はじめに

一貫性のあるエクスペリエンス

簡単な統合と構成

一般的な GDI テキスト構造との配置

FontControl を追加する

マークアップでの FontControl の宣言

リボンへの FontControl の追加

ContextPopup への FontControl の追加

Keytips

リボンリソースファイル

フォントコントロールのプロパティ

FontControl コマンドハンドラーを定義する

フィードバック

フィードバック

その他のリソース

フォント コントロール

はじめに

一貫性のあるエクスペリエンス

簡単な統合と構成

一般的な GDI テキスト構造との配置

FontControl を追加する

マークアップでの FontControl の宣言

リボンへの FontControl の追加

ContextPopup への FontControl の追加

Keytips

リボン リソース ファイル

フォント コントロールのプロパティ

FontControl コマンド ハンドラーを定義する

関連トピック

フィードバック

フィードバック

その他のリソース

フォントコントロール

リボンリソースファイル

フォントコントロールのプロパティ

FontControl コマンドハンドラーを定義する