FontControl 要素

  • [アーティクル]

フォント コントロールを表します。これは、フォント操作専用の個々のコントロールの特殊なコンテナーです。

使用法

<FontControl
  CommandName = "xs:positiveInteger or xs:string"
  FontType = "xs:string"
  IsGrowShrinkButtonGroupVisible = "Boolean"
  IsStrikethroughButtonVisible = "Boolean"
  IsUnderlineButtonVisible = "Boolean"
  IsHighlightButtonVisible = "Boolean"
  ShowVerticalFonts = "Boolean"
  ShowTrueTypeOnly = "Boolean"
  MinimumFontSize = "xs:positiveInteger"
  MaximumFontSize = "xs:positiveInteger"/>

属性

属性 Type 必須 説明
CommandName
 xs:positiveInteger または xs:string
 いいえ
 要素を Command に関連付 けます。

(xs:positiveInteger または xs:string)
文字列、2 ~ 59999 の整数値、または 0x2 と 0xea5f の間の 16 進数の値 (両端を含む)。
値はリボン XML ドキュメント内で一意である必要があります。
最大長: 100 文字。
FontType
 xs:string
 いいえ
 次のいずれかの値に制限されます。

(FontOnly)
既定値。
FontOnly 属性が true に設定されている FontControl 要素のスクリーン ショット。
FontType 属性を に設定するとFontOnly、次の機能が有効になります。
  • [フォント ファミリ ] コンボ ボックス。
  • [フォント サイズ ] コンボ ボックス。

  • 太字、 斜体、 下線、 取り消し線 のトグル ボタン。

    注:
    取り消し線と下線の切り替えボタンは既定で表示されますが、IsStrikethroughButtonVisible 属性と IsUnderlineButtonVisible 属性を にfalse設定することで非表示にすることができます。


(FontWithColor)
FontWithColor 属性が true に設定されている FontControl 要素のスクリーン ショット。
FontType 属性を に設定するとFontWithColor、次の機能が有効になります。
  • [フォント ファミリ ] コンボ ボックス。
  • [フォント サイズ ] コンボ ボックス。
  • [フォントの拡大 ] ボタンと [フォント サイズの縮小] ボタンと [デクリメント] ボタン。

  • 太字、 斜体、 下線、 取り消し線 のトグル ボタン。

    注:
    取り消し線と下線の切り替えボタンは既定で表示されますが、IsStrikethroughButtonVisible 属性と IsUnderlineButtonVisible 属性を にfalse設定することで非表示にすることができます。


  • テキストの色 の選択。

  • テキストの強調表示の色 の選択。

    注:
    このコントロールは既定では非表示になっていますが、 IsHighlightButtonVisible 属性を に true設定することで表示できます。


(RichFont)
RichFont 属性が true に設定されている FontControl 要素のスクリーン ショット。
FontType 属性を に設定するとRichFont、次の機能が有効になります。
  • [フォント ファミリ ] コンボ ボックス。
  • [フォント サイズ ] コンボ ボックス。
  • [フォントの拡大 ] ボタンと [フォント サイズの縮小] ボタンと [デクリメント] ボタン。

  • 太字、 斜体、 下線、 取り消し線 のトグル ボタン。

    注:
    取り消し線と下線の切り替えボタンは既定で表示され、IsStrikethroughButtonVisible 属性と IsUnderlineButtonVisible 属性を に設定して非表示にfalseすることはできません。


  • テキストの色 の選択。

  • テキストの強調表示の色 の選択。

    注:
    このコントロールは既定で表示され、 IsHighlightButtonVisible 属性を に設定して非表示に falseすることはできません。


  • 下付きと上付きのトグル ボタン。
IsGrowShrinkButtonGroupVisible
 ブール型
 いいえ
 Windows 8.1 以降
次のいずれかの値に制限されます。

注:
[拡大/縮小] ボタンが MiniToolbar に表示されることはありません。



(true)
FontType の値が または RichFontと等しい場合のFontWithColor既定値です。
(false)
FontType の値が と等しい場合のFontOnly既定値。
IsHighlightButtonVisible
 ブール型
 いいえ
 次のいずれかの値に制限されます (0 と 1 は無効です)。

注:
Color highlighting is available only from a FontControl when the value of the FontType attribute equals FontWithColor or RichFont.



(true)
FontType の値が または RichFontと等しい場合のFontWithColor既定値です。
FontType の値が または RichFontと等しいFontWithColor場合にのみ有効です。
(false)
FontType の値が と等しい場合のFontOnly既定値。
FontType の値が または FontWithColorと等しいFontOnly場合にのみ有効です。
IsStrikethroughButtonVisible
 ブール型
 いいえ
 次のいずれかの値に制限されます (0 と 1 は無効です)。

(true)
既定値。
(false)
FontType の値が または FontWithColorと等しいFontOnly場合にのみ有効です。
IsUnderlineButtonVisible
 ブール型
 いいえ
 次のいずれかの値に制限されます (0 と 1 は無効です)。

(true)
既定値。
(false)
FontType の値が または FontWithColorと等しいFontOnly場合にのみ有効です。
MaximumFontSize
 xs:positiveInteger
 いいえ
 表示するポイントの最大サイズ。

(xs:positiveInteger)
1 から 9999 までの整数値 (両端を含む)。
既定値は 9999 です。
MinimumFontSize
 xs:positiveInteger
 いいえ
 表示する最小ポイント サイズ。

(xs:positiveInteger)
1 から 9999 までの整数値 (両端を含む)。
既定値は 1 です。
ShowTrueTypeOnly
 ブール型
 いいえ
 次のいずれかの値に制限されます (0 と 1 は無効です)。

(true)
TrueType フォントと OpenType フォントのみを表示します。
(false)
既定値。 表示されるフォントの種類に制限はありません。
ShowVerticalFonts
 ブール型
 いいえ
 次のいずれかの値に制限されます (0 と 1 は無効です)。

注:
[フォント ファミリ] ボックスの一覧では、縦書きフォントの前に @ 記号が 付 きます。



(true)
既定値。 [フォント] コントロール パネルで [表示 ] に設定されている垂直 フォント を表示します。
(false)
縦書きテキストをサポートしていないアプリケーションで、[フォント] コントロール パネルで [表示] に設定されている垂直方向のフォントを非表示にすることができます。

注:
Windows Vista では、[ フォント ] コントロール パネルには [表示 ] または [ 非表示] の機能はありません。 この場合、 ShowVerticalFonts 属性を に設定する False必要があります。

子要素

子要素はありません。

親要素

要素
ControlGroup
グループ
MenuGroup

解説

省略可能。

ControlGroup、Group、または MenuGroup 要素ごとに、最大で 1 回発生する可能性があります。

マークアップで宣言された FontControl コマンド属性 ( Command.LabelTitle や Command.TooltipTitle など) は、 FontControl を構成する個々のコントロールの属性によってオーバーライドされます。

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

例

次の例では、3 種類の フォント コントロールの基本的なマークアップを示します。

コードのこのセクションでは、 FontControl コマンド宣言を示します。各宣言には Group コンテナー宣言が含まれています。

<!-- A FontOnly FontControl -->
<Command Name="cmdFontOnlyGroup"
         Symbol="cmdFontOnlyGroup"
         Comment="FontOnlyGroup"
         Id="50001"
         LabelTitle="FontOnly"/>
<Command Name="cmdFontOnly"
         Symbol="cmdFontOnly"
         Comment="FontOnly"
         Id="50010"/>

<!-- A FontWithColor FontControl -->
<Command Name="cmdFontWithColorGroup"
         Symbol="cmdFontWithColorGroup"
         Comment="FontWithColorGroup"
         Id="50002"
         LabelTitle="FontWithColor"/>
<Command Name="cmdFontWithColor"
         Symbol="cmdFontWithColor"
         Comment="FontWithColor"
         Id="50020"/>

<!-- A RichFont FontControl -->
<Command Name="cmdRichFontGroup"
         Symbol="cmdRichFontGroup"
         Comment="RichFontGroup"
         Id="50003"
         LabelTitle="RichFont"
         Keytip="ZF"/>
<Command Name="cmdRichFont"
         Symbol="cmdRichFont"
         Comment="RichFont"
         Id="50030"
         Keytip="RF"
         LabelTitle="test"
         TooltipTitle="test"/>

コードのこのセクションでは、各 FontControl と Group が 1 つのタブで宣言されている FontControl コントロールの宣言を示します。

<Tab CommandName="cmdTab1">
  <Group CommandName="cmdFontOnlyGroup"
         SizeDefinition="OneFontControl">
    <FontControl CommandName="cmdFontOnly"
                 FontType="FontOnly"
                 IsUnderlineButtonVisible="false"
                 IsStrikethroughButtonVisible="false"
                 MinimumFontSize="15"/>
  </Group>
  <Group CommandName="cmdFontWithColorGroup"
         SizeDefinition="OneFontControl">
    <FontControl CommandName="cmdFontWithColor"
                 FontType="FontWithColor"
                 IsUnderlineButtonVisible="false"
                 IsStrikethroughButtonVisible="false"
                 IsHighlightButtonVisible="true"
                 MinimumFontSize="15"/>
  </Group>
  <Group CommandName="cmdRichFontGroup"
         SizeDefinition="OneFontControl">
    <FontControl CommandName="cmdRichFont"
                 FontType="RichFont"
                 IsHighlightButtonVisible="true"
                 IsUnderlineButtonVisible="true"
                 IsStrikethroughButtonVisible="true"
                 ShowVerticalFonts="true"
                 MinimumFontSize="15"/>
  </Group>

要素情報

  • サポートされている最小システム: Windows 7
  • 空の場合: はい

関連項目

フォント コントロール

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

FontControl サンプル