Élément FontControl

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

Utilisation

<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
No
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 inclus.
La valeur doit être unique dans le document XML du ruban.
Longueur maximale : 100 caractères.
FontType
xs:string
No
Limité à l’une des valeurs suivantes :

(FontOnly)
Par défaut.
Screen shot of the FontControl element with the FontOnly attribute set to true.
La définition de l’attribut FontType pour FontOnly active les fonctionnalités suivantes :
  • Zone de liste déroulante famille de polices .
  • Zone de liste déroulante taille de police .
  • Boutons bascule gras, italique, soulignéet barré .

    [!Note]
    Les boutons de bascule barré et souligné s’affichent par défaut, mais peuvent être masqués en définissant les attributs IsStrikethroughButtonVisible et IsUnderlineButtonVisible sur false .


(FontWithColor)
Screen shot of the FontControl element with the FontWithColor attribute set to true.
La définition de l’attribut FontType pour FontWithColor active les fonctionnalités suivantes :
  • Zone de liste déroulante famille de polices .
  • Zone de liste déroulante taille de police .
  • Agrandir la police et réduire la taille de police de police des boutons d’incrémentation et de décrémentation.
  • Boutons bascule gras, italique, soulignéet barré .

    [!Note]
    Les boutons de bascule barré et souligné s’affichent par défaut, mais peuvent être masqués en définissant les attributs IsStrikethroughButtonVisible et IsUnderlineButtonVisible sur false .


  • Sélecteur de couleurs de couleur du texte .
  • Sélecteur de couleurs de couleur de mise en surbrillance du texte .

    [!Note]
    Ce contrôle est masqué par défaut, mais il peut être affiché en affectant à l’attribut IsHighlightButtonVisible la valeur true .


(RichFont)
Screen shot of the FontControl element with the RichFont attribute set to true.
La définition de l’attribut FontType pour RichFont active les fonctionnalités suivantes :
  • Zone de liste déroulante famille de polices .
  • Zone de liste déroulante taille de police .
  • Agrandir la police et réduire la taille de police de police des boutons d’incrémentation et de décrémentation.
  • Boutons bascule gras, italique, soulignéet barré .

    [!Note]
    Les boutons de bascule barré et souligné s’affichent par défaut et ne peuvent pas être masqués en définissant les attributs IsStrikethroughButtonVisible et IsUnderlineButtonVisible sur false .


  • Sélecteur de couleurs de couleur du texte .
  • Sélecteur de couleurs de couleur de mise en surbrillance du texte .

    [!Note]
    Ce contrôle s’affiche par défaut et ne peut pas être masqué en affectant à l’attribut IsHighlightButtonVisible la valeur false .


  • Boutons bascule en indice et en exposant .
IsGrowShrinkButtonGroupVisible
Boolean
Non
Windows 8 et versions ultérieures
Limité à l’une des valeurs suivantes :
[!Note]
Les boutons agrandir/rétrécir ne sont jamais affichés dans le MiniToolbar.


:
Valeur par défaut lorsque la valeur de FontType est égale à FontWithColor ou RichFont .
fausses
Valeur par défaut lorsque la valeur de FontType est égale à FontOnly .
IsHighlightButtonVisible
Boolean
Non
Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) :
[!Note]
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 .


:
Valeur par défaut lorsque la valeur de FontType est égale à FontWithColor ou RichFont .
Valide uniquement lorsque la valeur de FontType est égale à FontWithColor ou RichFont .
fausses
Valeur par défaut lorsque la valeur de FontType est égale à FontOnly .
Valide uniquement lorsque la valeur de FontType est égale à FontOnly ou FontWithColor .
IsStrikethroughButtonVisible
Boolean
Non
Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) :

:
Par défaut.
fausses
Valide uniquement lorsque la valeur de FontType est égale à FontOnly ou FontWithColor .
IsUnderlineButtonVisible
Boolean
Non
Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) :

:
Par défaut.
fausses
Valide uniquement lorsque la valeur de FontType est égale à FontOnly ou FontWithColor .
MaximumFontSize
xs:positiveInteger
No
Taille maximale en points à afficher.

(XS : positiveInteger)
Valeur entière comprise entre 1 et 9999 inclus.
La valeur par défaut est 9999.
MinimumFontSize
xs:positiveInteger
No
Taille minimale du point à afficher.

(XS : positiveInteger)
Valeur entière comprise entre 1 et 9999 inclus.
La valeur par défaut est 1.
ShowTrueTypeOnly
Boolean
Non
Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) :

:
Affiche uniquement les polices TrueType et OpenType.
fausses
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) :
[!Note]
Les polices verticales sont précédées d’un symbole @ dans la liste des familles de polices .


:
Par défaut. Affiche les polices verticales qui sont définies pour s' Afficher dans le panneau de configuration polices .
fausses
Permet à une application qui ne prend pas en charge le texte vertical de masquer les polices verticales qui sont définies pour s' Afficher dans le panneau de configuration polices .
[!Note]
dans Windows Vista, le panneau de configuration des polices n’offre pas de fonctionnalité d' affichage ou de masquage . Dans ce cas, l’attribut ShowVerticalFonts doit avoir la valeur False .

Éléments enfants

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

Éléments parents

Élément
ControlGroup
Groupe
MenuGroup

Remarques

Optionnel.

Peut se produire au plus une fois pour chaque élément ControlGroup, Groupou MenuGroup .

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

Toute tentative de sélection d’un échantillon 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 montre les déclarations de commande FontControl , chacune avec une déclaration de conteneur de groupe .

<!-- 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 groupe est déclaré dans un seul onglet.

<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 minimal pris en charge: Windows 7
  • Peut être vide: Oui

Voir aussi

Contrôle de contrôle de police

Propriétés du contrôle de police

Exemple FontControl