RichTextBox.ZoomFactor Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

RichTextBox.cs

Získá nebo nastaví aktuální úroveň RichTextBoxpřiblížení .

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

Hodnota vlastnosti

Single

Faktor, kterým je obsah ovládacího prvku zvětšen.

Výjimky

ArgumentException

Zadaný faktor přiblížení nepřepadl do přípustného rozsahu.

Příklady

Následující příklad kódu ukazuje, jak vytvořit RichTextBox přiblížení textu, automaticky vybere slova v textu ovládacího prvku, když je slovo poklikání a má okraj na pravé straně klientské oblasti ovládacího prvku. RichTextBox Pokud má ovládací prvek malou šířku, pomocí tohoto kódu se vytvoří RichTextBox místo, kde se každý znak textu zobrazí na vlastním řádku. Když v tomto svislém zobrazení kliknete na libovolnou část slova, vybere se všechny znaky slova bez ohledu na skutečnost, že se text zobrazí svisle. Tento příklad vyžaduje, abyste měli formulář, který obsahuje RichTextBox ovládací prvek s názvem 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

Poznámky

Hodnota této vlastnosti může být mezi 1/64 (0,015625) a 64,0, nikoli včetně. Hodnota 1,0 označuje, že u ovládacího prvku není použito žádné přiblížení. Funkce přiblížení funguje optimálně, když dokument obsahuje písma TrueType. Pokud se v dokumentu ovládacího prvku použije písmo, které není TrueType, ZoomFactor použije vlastnost nejbližší celočíselnou hodnotu. Pomocí této vlastnosti můžete uživateli RichTextBox ovládacího prvku povolit přiblížení oddílů dokumentace, které jsou příliš malé k zobrazení nebo zhuštění zobrazení, aby bylo možné zobrazit více dokumentu na obrazovce.