RichTextBox.ZoomFactor Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o nível de zoom atual do 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 da propriedade

Single

O fator pelo qual os conteúdos do controle são ampliados.

Exceções

ArgumentException

O fator de zoom especificado não ficou dentro do intervalo permitido.

Exemplos

O exemplo de código a seguir demonstra como criar um RichTextBox que amplia o texto, seleciona automaticamente palavras no texto do controle quando uma palavra é clicada duas vezes e tem uma margem no lado direito da área do cliente do controle. Se o RichTextBox controle tiver uma largura pequena, o uso desse código criará um RichTextBox local em que cada caractere de texto é exibido em sua própria linha. Enquanto estiver nessa posição de exibição vertical, clicar em qualquer parte de uma palavra selecionará todos os caracteres da palavra, independentemente do fato de que o texto é exibido verticalmente. Este exemplo exige que você tenha um formulário que contenha um RichTextBox controle chamado 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

Comentários

O valor dessa propriedade pode ser entre 1/64 (0,015625) e 64,0, não inclusivo. Um valor 1.0 indica que nenhum zoom é aplicado ao controle. O recurso de zoom é executado de forma ideal quando o documento contém fontes TrueType. Quando uma fonte que não é TrueType é usada dentro do documento do controle, a ZoomFactor propriedade usará o valor de número inteiro mais próximo. Você pode usar essa propriedade para permitir que o usuário do RichTextBox controle amplie as seções da documentação que são muito pequenas para exibir ou para condensar a exibição para permitir que mais do documento seja exibido na tela.