Élément FontControl

Article
09/03/2023

Représente un contrôle de police, qui est un conteneur spécialisé de contrôles individuels dédiés à la manipulation de police.

Usage

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

Attributs

Attribut	Type	Obligatoire	Description
CommandName	xs:positiveInteger ou xs:string	Non	Associe l’élément à une commande. (xs:positiveInteger ou xs:string) Chaîne, valeur entière comprise entre 2 et 59999, inclusive, ou valeur hexadécimale comprise entre 0x2 et 0xea5f, inclusive. La valeur doit être unique dans le document XML du ruban. Longueur maximale : 100 caractères.
FontType	xs:string	Non	Limité à l’une des valeurs suivantes : (FontOnly) Par défaut. La définition de l’attribut FontType pour `FontOnly` activer les fonctionnalités suivantes : Zone de liste déroulante Famille de polices. Zone de liste déroulante Taille de police. Boutons bascules gras, italiques, soulignés et barrés . Remarque : Les boutons togthrough et Soulignement sont affichés par défaut, mais peuvent être masqués en définissant les attributs IsStrikethroughButtonVisible et IsUnderlineButtonVisible sur `false`. (FontWithColor) La définition de l’attribut FontType pour `FontWithColor` activer les fonctionnalités suivantes : Zone de liste déroulante Famille de polices. Zone de liste déroulante Taille de police. Augmenter la police et Réduire la taille de police boutons incrémenter et décrémenter la police. Boutons bascules gras, italiques, soulignés et barrés . Remarque : Les boutons togthrough et Soulignement sont affichés par défaut, mais peuvent être masqués en définissant les attributs IsStrikethroughButtonVisible et IsUnderlineButtonVisible sur `false`. Sélecteur de couleur de texte . Sélecteur de couleur de couleur de surbrillance de texte . Remarque : Ce contrôle est masqué par défaut, mais peut être affiché en définissant l’attribut IsHighlightButtonVisible sur `true`. (RichFont) La définition de l’attribut FontType pour `RichFont` activer les fonctionnalités suivantes : Zone de liste déroulante Famille de polices. Zone de liste déroulante Taille de police. Augmenter la police et Réduire la taille de police boutons incrémenter et décrémenter la police. Boutons bascules gras, italiques, soulignés et barrés . Remarque : Les boutons bouton bascule Strikethrough et Soulignement sont affichés par défaut et ne peuvent pas être masqués en définissant les attributs IsStrikethroughButtonVisible et IsUnderlineButtonVisible sur `false`. Sélecteur de couleur de texte . Sélecteur de couleur de couleur de surbrillance de texte . Remarque : Ce contrôle s’affiche par défaut et ne peut pas être masqué en définissant l’attribut IsHighlightButtonVisible sur `false`. Boutons bascule d’indice et d’exposant.
IsGrowShrinkButtonGroupVisible	Boolean	Non	Windows 8 et versions ultérieures Limité à l’une des valeurs suivantes : Remarque : Les boutons Augmenter/Réduire ne s’affichent jamais dans miniToolbar. (true) Par défaut lorsque la valeur de FontType est `FontWithColor` égale à ou `RichFont`. (false) Par défaut lorsque la valeur de FontType est `FontOnly`égale à .
IsHighlightButtonVisible	Boolean	Non	Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) : Remarque : La mise en surbrillance des couleurs n’est disponible qu’à partir d’un FontControl lorsque la valeur de l’attribut FontType est égale `FontWithColor` à ou `RichFont`. (true) Par défaut lorsque la valeur de FontType est `FontWithColor` égale à ou `RichFont`. Valide uniquement lorsque la valeur de FontType est `FontWithColor` égale à ou `RichFont`. (false) Par défaut lorsque la valeur de FontType est `FontOnly`égale à . Valide uniquement lorsque la valeur de FontType est `FontOnly` égale à ou `FontWithColor`.
IsStrikethroughButtonVisible	Boolean	Non	Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) : (true) Par défaut. (false) Valide uniquement lorsque la valeur de FontType est `FontOnly` égale à ou `FontWithColor`.
IsUnderlineButtonVisible	Boolean	Non	Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) : (true) Par défaut. (false) Valide uniquement lorsque la valeur de FontType est `FontOnly` égale à ou `FontWithColor`.
MaximumFontSize	xs:positiveInteger	Non	Taille de point maximale à afficher. (xs:positiveInteger) Valeur entière comprise entre 1 et 9999, inclusivement. La valeur par défaut est 9999.
MinimumFontSize	xs:positiveInteger	Non	Taille de point minimale à afficher. (xs:positiveInteger) Valeur entière comprise entre 1 et 9999, inclusivement. La valeur par défaut est 1.
ShowTrueTypeOnly	Boolean	Non	Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) : (true) Affiche uniquement les polices TrueType et OpenType. (false) Par défaut. Aucune restriction n’est placée sur le type de polices affichées.
ShowVerticalFonts	Boolean	Non	Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) : Remarque : Les polices verticales sont précédées d’un symbole @ dans la liste de la famille de polices . (true) Par défaut. Affiche les polices verticales définies sur Afficher dans le panneau de configuration Polices . (false) Permet à une application qui ne prend pas en charge le texte vertical de masquer les polices verticales définies sur Afficher dans le panneau de configuration Polices . Remarque : Dans Windows Vista, le panneau de configuration Polices n’offre pas de fonctionnalité Afficher ou Masquer . Dans ce cas, l’attribut ShowVerticalFonts doit être défini sur `False`.

Éléments enfants

Il n’y a pas d’éléments enfants.

Éléments parents

Élément
ControlGroup
Groupe
MenuGroup

Remarques

facultatif.

Peut se produire au maximum une fois pour chaque élément ControlGroup, Group ou MenuGroup .

Tous les attributs de la commande FontControl déclarés dans le balisage, tels que Command.LabelTitle ou Command.TooltipTitle, sont remplacés par les attributs des contrôles individuels qui composent fontControl.

Toute tentative de sélection d’une nuance de couleur dans le sélecteur de couleurs d’un contrôle de police peut entraîner une violation d’accès si aucun gestionnaire de commandes n’est associé au contrôle.

Exemples

L’exemple suivant illustre le balisage de base pour les trois types de contrôle de police.

Cette section de code présente les déclarations fontControl Command, chacune avec une déclaration de conteneur 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"/>

Cette section de code montre les déclarations de contrôle FontControl où chaque FontControl et chaque groupe est déclaré dans un onglet unique.

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

Informations sur les éléments

Système minimum pris en charge : Windows 7
Peut être vide : Oui

Voir aussi

Contrôle de police
Propriétés du contrôle de police
FontControl, exemple