RichTextBox.ZoomFactor Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia bieżący poziom powiększenia obiektu 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

Wartość właściwości

Single

Współczynnik, za pomocą którego zawartość kontrolki jest powiększana.

Wyjątki

ArgumentException

Określony współczynnik powiększenia nie mieścił się w dopuszczalnym zakresie.

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć obiekt RichTextBox powiększający tekst, automatycznie wybiera wyrazy w tekście kontrolki po dwukrotnym kliknięciu wyrazu i ma margines po prawej stronie obszaru klienta kontrolki. Jeśli kontrolka RichTextBox ma małą szerokość, użycie tego kodu spowoduje utworzenie RichTextBox miejsca, w którym każdy znak tekstu jest wyświetlany we własnym wierszu. W tym pionowym położeniu wyświetlania kliknięcie dowolnej części wyrazu spowoduje zaznaczenie wszystkich znaków wyrazu niezależnie od faktu, że tekst jest wyświetlany w pionie. W tym przykładzie wymagany jest formularz zawierający kontrolkę RichTextBox o nazwie 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

Uwagi

Wartość tej właściwości może należeć do zakresu od 1 do 64 (0,015625) do 64,0, a nie włącznie. Wartość 1.0 wskazuje, że do kontrolki nie zastosowano powiększenia. Funkcja powiększania działa optymalnie, gdy dokument zawiera czcionki TrueType. Jeśli czcionka, która nie jest wartością TrueType, jest używana w dokumencie kontrolki, ZoomFactor właściwość będzie używać najbliższej wartości całkowitej. Możesz użyć tej właściwości, aby umożliwić użytkownikowi RichTextBox kontrolki powiększenie sekcji dokumentacji, które są zbyt małe, aby wyświetlić lub skondensować widok, aby umożliwić wyświetlanie większej liczby dokumentów na ekranie.