StringFormatFlags Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica as informações de exibição e layout para cadeias de caracteres de texto.
Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.
public enum class StringFormatFlags[System.Flags]
public enum StringFormatFlags[<System.Flags>]
type StringFormatFlags = Public Enum StringFormatFlags- Herança
- Atributos
Campos
| Nome | Valor | Description |
|---|---|---|
| DirectionRightToLeft | 1 | O texto é exibido da direita para a esquerda. |
| DirectionVertical | 2 | O texto é alinhado verticalmente. |
| FitBlackBox | 4 | Partes de caracteres têm permissão para sobrepor o retângulo de layout da cadeia de caracteres. Por padrão, os caracteres são reposicionados para evitar qualquer saliência. |
| DisplayFormatControl | 32 | Caracteres de controle, como a marca da esquerda para a direita, são mostrados na saída com um glifo representativo. |
| NoFontFallback | 1024 | O fallback para fontes alternativas para caracteres sem suporte na fonte solicitada está desabilitado. Todos os caracteres ausentes são exibidos com o glifo ausente das fontes, geralmente um quadrado aberto. |
| MeasureTrailingSpaces | 2048 | Inclui o espaço à direita no final de cada linha. Por padrão, o retângulo de limite retornado pelo MeasureString método exclui o espaço no final de cada linha. Defina esse sinalizador para incluir esse espaço na medida. |
| NoWrap | 4096 | O encapsulamento de texto entre linhas quando a formatação dentro de um retângulo é desabilitada. Esse sinalizador é implícito quando um ponto é passado em vez de um retângulo ou quando o retângulo especificado tem um comprimento de linha zero. |
| LineLimit | 8192 | Somente linhas inteiras são dispostas no retângulo de formatação. Por padrão, o layout continua até o final do texto ou até que não haja mais linhas visíveis como resultado do recorte, o que ocorrer primeiro. Observe que as configurações padrão permitem que a última linha seja parcialmente obscurecida por um retângulo de formatação que não seja um múltiplo inteiro da altura da linha. Para garantir que apenas linhas inteiras sejam vistas, especifique esse valor e tenha cuidado para fornecer um retângulo de formatação pelo menos tão alto quanto a altura de uma linha. |
| NoClip | 16384 | Partes pendentes de glifos e texto desembrulhado que chega fora do retângulo de formatação têm permissão para mostrar. Por padrão, todas as partes de texto e glifo que chegam fora do retângulo de formatação são recortadas. |
Exemplos
O exemplo de código a seguir demonstra os seguintes membros:
Este exemplo foi projetado para ser usado com o Windows Forms. Cole o código em um formulário e chame o ShowLineAndAlignment método ao manipular o evento do Paint formulário, passando e como PaintEventArgs.
private:
void ShowLineAndAlignment( PaintEventArgs^ e )
{
// Construct a new Rectangle .
Rectangle displayRectangle = Rectangle(Point(40,40),System::Drawing::Size( 80, 80 ));
// Construct 2 new StringFormat objects
StringFormat^ format1 = gcnew StringFormat( StringFormatFlags::NoClip );
StringFormat^ format2 = gcnew StringFormat( format1 );
// Set the LineAlignment and Alignment properties for
// both StringFormat objects to different values.
format1->LineAlignment = StringAlignment::Near;
format1->Alignment = StringAlignment::Center;
format2->LineAlignment = StringAlignment::Center;
format2->Alignment = StringAlignment::Far;
// Draw the bounding rectangle and a string for each
// StringFormat object.
e->Graphics->DrawRectangle( Pens::Black, displayRectangle );
e->Graphics->DrawString( "Showing Format1", this->Font, Brushes::Red, displayRectangle, format1 );
e->Graphics->DrawString( "Showing Format2", this->Font, Brushes::Red, displayRectangle, format2 );
}
private void ShowLineAndAlignment(PaintEventArgs e)
{
// Construct a new Rectangle .
Rectangle displayRectangle =
new Rectangle (new Point(40, 40), new Size (80, 80));
// Construct 2 new StringFormat objects
StringFormat format1 = new StringFormat(StringFormatFlags.NoClip);
StringFormat format2 = new StringFormat(format1);
// Set the LineAlignment and Alignment properties for
// both StringFormat objects to different values.
format1.LineAlignment = StringAlignment.Near;
format1.Alignment = StringAlignment.Center;
format2.LineAlignment = StringAlignment.Center;
format2.Alignment = StringAlignment.Far;
// Draw the bounding rectangle and a string for each
// StringFormat object.
e.Graphics.DrawRectangle(Pens.Black, displayRectangle);
e.Graphics.DrawString("Showing Format1", this.Font,
Brushes.Red, (RectangleF)displayRectangle, format1);
e.Graphics.DrawString("Showing Format2", this.Font,
Brushes.Red, (RectangleF)displayRectangle, format2);
}
Private Sub ShowLineAndAlignment(ByVal e As PaintEventArgs)
' Construct a new Rectangle.
Dim displayRectangle _
As New Rectangle(New Point(40, 40), New Size(80, 80))
' Construct two new StringFormat objects
Dim format1 As New StringFormat(StringFormatFlags.NoClip)
Dim format2 As New StringFormat(format1)
' Set the LineAlignment and Alignment properties for
' both StringFormat objects to different values.
format1.LineAlignment = StringAlignment.Near
format1.Alignment = StringAlignment.Center
format2.LineAlignment = StringAlignment.Center
format2.Alignment = StringAlignment.Far
' Draw the bounding rectangle and a string for each
' StringFormat object.
e.Graphics.DrawRectangle(Pens.Black, displayRectangle)
e.Graphics.DrawString("Showing Format1", Me.Font, Brushes.Red, _
RectangleF.op_Implicit(displayRectangle), format1)
e.Graphics.DrawString("Showing Format2", Me.Font, Brushes.Red, _
RectangleF.op_Implicit(displayRectangle), format2)
End Sub
Comentários
StringFormatFlags é usado pela StringFormat classe.
Note
O campo FitBlackBox foi mal identificado e seu comportamento é semelhante ao NoFitBlackBox campo na implementação original do GDI+.