RichTextBox.ZoomFactor Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

RichTextBox.cs

Obtient ou définit le niveau de zoom actuel du RichTextBox.

public:
 property float ZoomFactor { float get(); void set(float value); };

public float ZoomFactor { get; set; }

member this.ZoomFactor : single with get, set

Public Property ZoomFactor As Single

Valeur de propriété

Single

Facteur par lequel le contenu du contrôle est zoomé.

Exceptions

ArgumentException

Le facteur de zoom spécifié n’est pas compris dans la plage autorisée.

Exemples

L’exemple de code suivant montre comment créer un RichTextBox zoom avant sur le texte, sélectionne automatiquement les mots dans le texte du contrôle lorsqu’un mot est double-cliqué et a une marge sur le côté droit de la zone cliente du contrôle. Si le contrôle a une petite largeur, l’utilisation RichTextBox de ce code crée un RichTextBox emplacement où chaque caractère de texte est affiché sur sa propre ligne. Dans cette position d’affichage verticale, le fait de cliquer sur n’importe quelle partie d’un mot sélectionne tous les caractères du mot, quel que soit le fait que le texte s’affiche verticalement. Cet exemple nécessite que vous disposiez d’un formulaire qui contient un RichTextBox contrôle nommé richTextBox1.

private:
   void ZoomMyRichTextBox()
   {
      // Enable users to select entire word when double clicked.
      richTextBox1->AutoWordSelection = true;

      // Clear contents of control.
      richTextBox1->Clear();

      // Set the right margin to restrict horizontal text.
      richTextBox1->RightMargin = 2;

      // Set the text for the control.
      richTextBox1->SelectedText = "Alpha Bravo Charlie Delta Echo Foxtrot";

      // Zoom by 2 points.
      richTextBox1->ZoomFactor = 2.0f;
   }

private void ZoomMyRichTextBox()
{
    // Enable users to select entire word when double clicked.
    richTextBox1.AutoWordSelection = true;
    // Clear contents of control.
    richTextBox1.Clear();
    // Set the right margin to restrict horizontal text.
    richTextBox1.RightMargin = 2;
    // Set the text for the control.
    richTextBox1.SelectedText = "Alpha Bravo Charlie Delta Echo Foxtrot";
    // Zoom by 2 points.
    richTextBox1.ZoomFactor = 2.0f;
}

Private Sub ZoomMyRichTextBox()
    ' Enable users to select entire word when double clicked.
    richTextBox1.AutoWordSelection = True
    ' Clear contents of control.
    richTextBox1.Clear()
    ' Set the right margin to restrict horizontal text.
    richTextBox1.RightMargin = 2
    ' Set the text for the control.
    richTextBox1.SelectedText = "Alpha Bravo Charlie Delta Echo Foxtrot"
    ' Zoom by 2 points.
    richTextBox1.ZoomFactor = 2.0F
End Sub

Remarques

La valeur de cette propriété peut être comprise entre 1/64 (0,015625) et 64.0, et non inclus. La valeur 1.0 indique qu’aucun zoom n’est appliqué au contrôle. La fonctionnalité de zoom s’effectue de manière optimale lorsque le document contient des polices TrueType. Lorsqu’une police qui n’est pas TrueType est utilisée dans le document du contrôle, la ZoomFactor propriété utilise la valeur de nombre entier la plus proche. Vous pouvez utiliser cette propriété pour permettre à l’utilisateur RichTextBox du contrôle d’effectuer un zoom avant dans des sections de la documentation trop petite pour afficher ou pour condenser l’affichage pour permettre à un plus grand nombre de documents d’être affichés à l’écran.