RichTextBox.ZoomFactor RichTextBox.ZoomFactor RichTextBox.ZoomFactor RichTextBox.ZoomFactor Property

Définition

Obtient ou définit le niveau de zoom actuel de RichTextBox.Gets or sets the current zoom level of the 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é

Facteur de zoom appliqué au contenu du contrôle.The factor by which the contents of the control is zoomed.

Exceptions

Le facteur de zoom spécifié n'est pas compris dans la plage autorisée.The specified zoom factor did not fall within the permissible range.

Exemples

L’exemple de code suivant montre comment créer un RichTextBox qui effectue un zoom avant sur du texte, sélectionne automatiquement des mots dans le texte du contrôle lorsqu’un mot est double-cliqué, et a une marge à droite de la zone cliente du contrôle.The following code example demonstrates how to create a RichTextBox that zooms in on text, automatically selects words in the text of the control when a word is double-clicked, and has a margin on the right side of the client area of the control. Si le RichTextBox contrôle a une petite largeur, l’utilisation de ce code crée RichTextBox un où chaque caractère de texte s’affiche sur sa propre ligne.If the RichTextBox control has a small width, using this code will create a RichTextBox where each character of text is displayed on its own line. Dans cette position d’affichage verticale, le fait de cliquer sur une partie d’un mot sélectionne tous les caractères du mot, indépendamment du fait que le texte est affiché verticalement.While in this vertical display position, clicking on any part of a word will select all characters of the word regardless of the fact that the text is displayed vertically. Cet exemple nécessite que vous disposiez d’un formulaire qui RichTextBox contient un richTextBox1contrôle nommé.This example requires that you have a form that contains a RichTextBox control named 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, pas inclusive.The value of this property can be between 1/64 (0.015625) and 64.0, not inclusive. La valeur 1,0 indique qu’aucun zoom n’est appliqué au contrôle.A value of 1.0 indicates that no zoom is applied to the control. La fonctionnalité zoom fonctionne de façon optimale lorsque le document contient des polices TrueType.The zoom feature performs optimally when the document contains TrueType fonts. Quand 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.When a font that is not TrueType is used within the document of the control, the ZoomFactor property will use the nearest whole number value. Vous pouvez utiliser cette propriété pour permettre à l’utilisateur du RichTextBox contrôle de zoomer sur des sections de la documentation qui sont trop petites pour être affichées ou de condenser la vue pour permettre l’affichage de davantage de documents à l’écran.You can use this property to enable the user of the RichTextBox control to zoom into sections of the documentation that are too small to view or to condense the view to enable more of the document to be viewed on screen.

S’applique à