RichTextBox.ZoomFactor Propriedade

Definição

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 de Propriedade

O fator pelo qual o conteúdo do controlo é ampliado.

Exceções

O fator de zoom especificado não se enquadrava no intervalo permitido.

Exemplos

O exemplo de código seguinte demonstra como criar um RichTextBox que faz zoom no texto, seleciona automaticamente palavras no texto do controlo quando uma palavra é dupla clique, e tem uma margem no lado direito da área cliente do controlo. Se o RichTextBox controlo tiver uma largura pequena, usar este código criará um RichTextBox onde cada carácter de texto é exibido numa linha própria. Enquanto estiver nesta posição de exibição vertical, clicar em qualquer parte de uma palavra seleciona todos os caracteres da palavra, independentemente de o texto ser exibido verticalmente. Este exemplo exige que tenha uma forma que contenha um RichTextBox controlo 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

Observações

O valor desta propriedade pode variar entre 1/64 (0,015625) e 64,0, não inclusivo. Um valor de 1,0 indica que não é aplicado qualquer zoom ao controlo. A funcionalidade de zoom funciona de forma ótima quando o documento contém fontes TrueType. Quando uma fonte que não é TrueType é usada no documento do controlo, a ZoomFactor propriedade usará o valor inteiro mais próximo. Pode usar esta propriedade para permitir que o utilizador do RichTextBox controlo amplie secções da documentação que sejam demasiado pequenas para visualizar ou para condensar a vista e permitir que mais do documento seja visualizado no ecrã.

Aplica-se a