RichTextBox.ZoomFactor Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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ã.