RichTextBox.ZoomFactor Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den aktuellen Zoomfaktor der RichTextBox ab oder legt diesen fest.

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

Eigenschaftswert

Single

Der Faktor, um den für den Inhalt des Steuerelements ein Zoom durchgeführt wird.

Ausnahmen

ArgumentException

Der angegebene Zoomfaktor liegt nicht im zulässigen Bereich.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Ein erstellt RichTextBox wird, das text verkleinert, automatisch Wörter im Text des Steuerelements auswählt, wenn auf ein Wort doppelklicken wird, und einen Rand auf der rechten Seite des Clientbereichs des Steuerelements hat. Wenn das RichTextBox Steuerelement eine geringe Breite aufweist, wird mit diesem Code ein RichTextBox erstellt, in dem jedes Textzeichen in einer eigenen Zeile angezeigt wird. In dieser vertikalen Anzeigeposition werden beim Klicken auf einen beliebigen Teil eines Worts alle Zeichen des Worts ausgewählt, unabhängig davon, ob der Text vertikal angezeigt wird. Dieses Beispiel erfordert, dass Sie über ein Formular verfügen, das ein RichTextBox Steuerelement mit dem Namen richTextBox1enthält.

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

Hinweise

Der Wert dieser Eigenschaft kann zwischen 1/64 (0,015625) und 64,0 liegen, nicht inklusive. Der Wert 1,0 gibt an, dass kein Zoom auf das Steuerelement angewendet wird. Die Zoomfunktion funktioniert optimal, wenn das Dokument TrueType-Schriftarten enthält. Wenn im Dokument des Steuerelements eine Schriftart verwendet wird, die nicht TrueType ist, verwendet die ZoomFactor -Eigenschaft den nächsten ganzen Zahlenwert. Sie können diese Eigenschaft verwenden, um dem Benutzer des RichTextBox Steuerelements das Zoomen von Abschnitten der Dokumentation zu ermöglichen, die für die Anzeige zu klein sind, oder um die Ansicht zu verkleinern, damit ein größerer Teil des Dokuments auf dem Bildschirm angezeigt werden kann.