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"/>

属性

属性 类型 必须 说明
CommandName
 xs：positiveInteger 或 xs：string
 否
 将 元素与 Command 相关联。

(xs：positiveInteger 或 xs：string)
一个字符串，一个介于 2 和 59999 之间的整数值（含），或介于 0x2 和 0xea5f 之间的十六进制值（含）。
该值在功能区 XML 文档中必须是唯一的。
最大长度：100 个字符。
FontType
 xs:string
 否
 限制为以下值之一：

(FontOnly)
默认。
FontControl 元素的屏幕截图，其中 FontOnly 属性设置为 true。
将 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 及更高版本
限制为以下值之一：

注意：
“增长/收缩”按钮永远不会显示在 MiniToolbar 中。



(true)
当 FontType 的值等于 FontWithColor 或 RichFont时，默认值。
(false)
当 FontType 的值等于 时， FontOnly默认值为 。
IsHighlightButtonVisible
 布尔
 否
 限制为以下值之一 (0 和 1) 无效：

注意：
当 FontType 属性的值等于 FontWithColor 或 RichFont时，颜色突出显示仅在 FontControl 中可用。



(true)
当 FontType 的值等于 FontWithColor 或 RichFont时，默认值。
仅当 FontType 的值等于 FontWithColor 或 RichFont时有效。
(false)
当 FontType 的值等于 时， FontOnly默认值为 。
仅当 FontType 的值等于 FontOnly 或 FontWithColor时有效。
IsStrikethroughButtonVisible
 布尔
 否
 限制为以下值之一 (0 和 1) 无效：

(true)
默认。
(false)
仅当 FontType 的值等于 FontOnly 或 FontWithColor时有效。
IsUnderlineButtonVisible
 布尔
 否
 限制为以下值之一 (0 和 1) 无效：

(true)
默认。
(false)
仅当 FontType 的值等于 FontOnly 或 FontWithColor时有效。
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 元素，最多可以发生一次。

在标记中声明的任何 FontControl Command 属性（如 Command.LabelTitle 或 Command.TooltipTitle）将由构成 FontControl 的单个控件的属性重写。

如果没有命令处理程序与控件关联，则任何尝试从 字体控件 的颜色选取器中选择颜色样本都可能导致访问冲突。

示例

以下示例演示了三种类型的 字体控件的基本标记。

此部分代码显示 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 控件声明，其中每个 FontControl 和 Group 都在单个选项卡中声明。

<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 示例