RichTextBox.ZoomFactor Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta lo zoom corrente dell'oggetto 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

Valore della proprietà

Single

Fattore in base al quale al contenuto del controllo viene applicato lo zoom.

Eccezioni

ArgumentException

Il fattore di zoom specificato non è compreso nell'intervallo consentito.

Esempio

Nell'esempio di codice seguente viene illustrato come creare un RichTextBox oggetto che esegue lo zoom avanti sul testo, seleziona automaticamente le parole nel testo del controllo quando viene fatto doppio clic su una parola e ha un margine sul lato destro dell'area client del controllo. Se il controllo ha una larghezza ridotta, l'uso RichTextBox di questo codice creerà un oggetto RichTextBox in cui ogni carattere di testo viene visualizzato sulla propria riga. Mentre in questa posizione di visualizzazione verticale, facendo clic su qualsiasi parte di una parola verranno selezionati tutti i caratteri della parola indipendentemente dal fatto che il testo viene visualizzato verticalmente. In questo esempio è necessario disporre di una maschera contenente un RichTextBox controllo denominato 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

Commenti

Il valore di questa proprietà può essere compreso tra 1/64 (0,015625) e 64,0, non inclusivo. Il valore 1.0 indica che al controllo non viene applicato alcuno zoom. La funzionalità di zoom viene eseguita in modo ottimale quando il documento contiene tipi di carattere TrueType. Quando viene utilizzato un tipo di carattere diverso da TrueType all'interno del documento del controllo, la ZoomFactor proprietà utilizzerà il valore numero intero più vicino. È possibile utilizzare questa proprietà per consentire all'utente del RichTextBox controllo di ingrandire le sezioni della documentazione troppo piccole da visualizzare o di condensare la visualizzazione per consentire la visualizzazione di un maggior numero di documenti sullo schermo.