Элемент FontControl

Статья
06/13/2023

Представляет элемент управления шрифтом, который является специализированным контейнером отдельных элементов управления, предназначенных для обработки шрифта.

Использование

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

Атрибуты

attribute	Тип	Обязательно	Описание
CommandName	xs:positiveInteger или xs:string	Нет	Связывает элемент с command. (xs:positiveInteger или xs:string) Строка, целочисленное значение от 2 до 59999 включительно или шестнадцатеричное значение в диапазоне от 0x2 до 0xea5f включительно. Значение должно быть уникальным в XML-документе ленты. Максимальная длина: 100 символов.
FontType	xs:string	Нет	Ограничивается одним из следующих значений: (FontOnly) По умолчанию. Если задать для атрибута FontType значение `FontOnly` , можно использовать следующие функциональные возможности: Поле со списком семейства шрифтов. Поле со списком Размер шрифта. Полужирный, курсив, подчеркивание и зачеркивные кнопки. Примечание. Переключатели Зачеркивать и Подчеркивание отображаются по умолчанию, но их можно скрыть, задав атрибутам IsStrikethroughButtonVisible и IsUnderlineButtonVisible значение `false`. (FontWithColor) Если задать для атрибута FontType значение `FontWithColor` , можно использовать следующие функциональные возможности: Поле со списком семейства шрифтов. Поле со списком размер шрифта. Кнопки увеличения размера шрифта и уменьшения размера шрифта. Полужирный, курсив, подчеркивание и зачеркивные кнопки. Примечание. Переключатели Зачеркивать и Подчеркивание отображаются по умолчанию, но их можно скрыть, задав атрибутам IsStrikethroughButtonVisible и IsUnderlineButtonVisible значение `false`. Средство выбора цвета текста . Средство выбора цвета выделения текста . Примечание. Этот элемент управления по умолчанию скрыт, но его можно отобразить, задав для атрибута IsHighlightButtonVisible значение `true`. (RichFont) Если задать для атрибута FontType значение `RichFont` , можно использовать следующие функциональные возможности: Поле со списком семейства шрифтов. Поле со списком размер шрифта. Кнопки увеличения размера шрифта и уменьшения размера шрифта. Полужирный, курсив, подчеркивание и зачеркивные кнопки. Примечание. Переключатели Зачеркивать и Подчеркивать отображаются по умолчанию и не могут быть скрыты, задав атрибутам IsStrikethroughButtonVisible и IsUnderlineButtonVisible значение `false`. Средство выбора цвета текста . Средство выбора цвета выделения текста . Примечание. Этот элемент управления отображается по умолчанию и не может быть скрыт, задав атрибуту IsHighlightButtonVisible значение `false`. Подстрочные и надстрочные переключатели.
IsGrowShrinkButtonGroupVisible	Логическое	Нет	Windows 8 и более поздней версии Ограничивается одним из следующих значений: Примечание. Кнопки Увеличения и сжатия никогда не отображаются на мини-панели. (true) Значение по умолчанию, если значение FontType равно `FontWithColor` или `RichFont`. (false) Значение по умолчанию, если значение FontType равно `FontOnly`.
IsHighlightButtonVisible	Логическое	Нет	Ограничено одним из следующих значений (недопустимы 0 и 1): Примечание. Выделение цвета доступно только из FontControl , если значение атрибута FontType равно `FontWithColor` или `RichFont`. (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

Все атрибуты Команды FontControl , объявленные в разметке, такие как 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

Поделиться через