RichTextBox.ZoomFactor Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el nivel de zoom actual de 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

Valor de propiedad

Single

Factor en virtud del cual se aplica el zoom al contenido del control.

Excepciones

ArgumentException

El factor de zoom especificado no se encuentra dentro del margen permitido.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un RichTextBox objeto que amplía el texto, selecciona automáticamente palabras en el texto del control cuando se hace doble clic en una palabra y tiene un margen en el lado derecho del área de cliente del control. Si el RichTextBox control tiene un ancho pequeño, el uso de este código creará un RichTextBox donde cada carácter de texto se muestra en su propia línea. Mientras esté en esta posición de visualización vertical, al hacer clic en cualquier parte de una palabra se seleccionarán todos los caracteres de la palabra, independientemente del hecho de que el texto se muestre verticalmente. En este ejemplo se requiere que tenga un formulario que contenga un RichTextBox control denominado 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

Comentarios

El valor de esta propiedad puede estar comprendido entre 1/64 (0,015625) y 64,0, no incluido. Un valor de 1.0 indica que no se aplica ningún zoom al control. La característica de zoom funciona de forma óptima cuando el documento contiene fuentes TrueType. Cuando se usa una fuente que no es TrueType en el documento del control, la ZoomFactor propiedad usará el valor de número entero más cercano. Puede usar esta propiedad para permitir que el usuario del RichTextBox control amplíe las secciones de la documentación que son demasiado pequeñas para ver o condensar la vista para permitir que se vea más del documento en pantalla.