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)
FontControl 元素的螢幕擷取畫面，其中 FontWithColor 屬性設定為 true。
設定 FontType 屬性以 FontWithColor 啟用下列功能：
  • 字型系列 下拉式方塊。
  • 字型大小 下拉式方塊。
  • 成長字型 和 縮小字 號遞增和遞減按鈕。

  • 粗體、 斜體、 底線和 刪除線 切換按鈕。

    注意：
    刪除線和底線切換按鈕預設會顯示，但可以將IsStrikethroughButtonVisible和IsUnderlineButtonVisible屬性設定為 false 來隱藏。


  • 文字色彩色彩 選擇器。

  • 文字醒目提示色彩 選擇器。

    注意：
    預設會隱藏此控制項，但可藉由將 IsHighlightButtonVisible 屬性設定為 true 來顯示。


(RichFont)
FontControl 元素的螢幕擷取畫面，其中 RichFont 屬性設定為 true。
設定 FontType 屬性以 RichFont 啟用下列功能：
  • 字型系列 下拉式方塊。
  • 字型大小 下拉式方塊。
  • 成長字型 和 縮小字 號遞增和遞減按鈕。

  • 粗體、 斜體、 底線和 刪除線 切換按鈕。

    注意：
    刪除線和底線切換按鈕預設會顯示，而且無法透過將IsStrikethroughButtonVisible和IsUnderlineButtonVisible屬性設定為 false 來隱藏。


  • 文字色彩色彩 選擇器。

  • 文字醒目提示色彩 選擇器。

    注意：
    預設會顯示此控制項，而且無法透過將 IsHighlightButtonVisible 屬性設定為 false 來隱藏。


  • 下標 和 上標 切換按鈕。
IsGrowShrinkButtonGroupVisible
 Boolean
 No
 Windows 8 和更新版本
限制為下列其中一個值：

注意：
MiniToolbar中永遠不會顯示 [成長/壓縮] 按鈕。



(true)
當 FontType的值等於 FontWithColor 或 RichFont 時，預設值。
(false)
當 FontType的值等於 FontOnly 時，預設值為 。
IsHighlightButtonVisible
 Boolean
 No
 限制為下列其中一個值， (0 和 1 無效) ：

注意：
只有在FontType屬性的值等於 FontWithColor 或 RichFont 時，才能從FontControl使用色彩醒目提示。



(true)
當 FontType的值等於 FontWithColor 或 RichFont 時，預設值。
只有在 FontType 的值等於 FontWithColor 或 RichFont 時才有效。
(false)
當 FontType的值等於 FontOnly 時，預設值為 。
只有在 FontType 的值等於 FontOnly 或 FontWithColor 時才有效。
IsStrikethroughButtonVisible
 Boolean
 No
 限制為下列其中一個值， (0 和 1 無效) ：

(true)
預設值。
(false)
只有在 FontType 的值等於 FontOnly 或 FontWithColor 時才有效。
IsUnderlineButtonVisible
 Boolean
 No
 限制為下列其中一個值， (0 和 1 無效) ：

(true)
預設值。
(false)
只有在 FontType 的值等於 FontOnly 或 FontWithColor 時才有效。
MaximumFontSize
 xs:positiveInteger
 否
 要顯示的點大小上限。

(xs：positiveInteger)
介於 1 到 9999 之間的整數值，包含。
預設值為 9999。
MinimumFontSize
 xs:positiveInteger
 否
 要顯示的最小點大小。

(xs：positiveInteger)
介於 1 到 9999 之間的整數值，包含。
預設值為 1。
ShowTrueTypeOnly
 Boolean
 No
 限制為下列其中一個值， (0 和 1 無效) ：

(true)
只顯示 TrueType 和 OpenType 字型。
(false)
預設值。 不會限制顯示的字型類型。
ShowVerticalFonts
 Boolean
 No
 限制為下列其中一個值， (0 和 1 無效) ：

注意：
垂直字型前面會加上字型 系列 清單中的 @ 符號。



(true)
預設值。 在 [字型] 控制台中顯示設定為 [顯示 ] 的垂直字 型 。
(false)
允許不支援垂直文字的應用程式隱藏在 [字型] 控制台中設定為[顯示] 的任何垂直字型。

注意：
在 Windows Vista 中， [字型 ] 控制台不提供 [顯示 ] 或 [ 隱藏 ] 功能。 在此情況下， ShowVerticalFonts 屬性必須設定為 False 。

子元素

沒有子項目。

父元素

元素
ControlGroup
組
MenuGroup

備註

選擇性。

每個 ControlGroup、 Group或 MenuGroup 元素最多可能會發生一次。

在標記中宣告的任何 FontControl Command 屬性，例如 Command.LabelTitle 或 Command.TooltipTitle，都是由組成 FontControl之個別控制項的屬性覆寫。

如果沒有任何命令處理常式與控制項相關聯，嘗試從 字型控制項 的色彩選擇器中選取色彩樣板，可能會導致存取違規。

範例

下列範例示範三種 字型控制項類型的基本標記。

這一節的程式碼會顯示 FontControl Command 宣告，每個宣告都有 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 範例