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 layout e de exibição 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
| DirectionRightToLeft | 1 | O texto é exibido da direita para a esquerda. |
| DirectionVertical | 2 | O texto é alinhado verticalmente. |
| DisplayFormatControl | 32 | Caracteres de controle, como a marca da esquerda para a direita, são mostrados na saída com um glifo representativo. |
| FitBlackBox | 4 | Partes de caracteres têm permissão para criar uma folga no retângulo do layout da cadeia de caracteres. Por padrão, os caracteres são reposicionados para evitar qualquer folga. |
| LineLimit | 8192 | Somente linhas inteiras ficam 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 são visíveis como resultado de 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 é um múltiplo inteiro da altura da linha. Para garantir que apenas linhas inteiras sejam vistas, especifique esse valor e tenha cuidado ao fornecer um retângulo formatação no mínimo tão alto quanto a altura de uma linha. |
| MeasureTrailingSpaces | 2048 | Inclui o espaço à direita no final de cada linha. Por padrão, o retângulo limite retornado pelo método MeasureString exclui o espaço no final de cada linha. Defina esse sinalizador para incluir esse espaço na medida. |
| NoClip | 16384 | Partes suspensas de glifos e o texto sem quebra que ultrapassam o retângulo de formatação têm permissão para serem mostrados. Por padrão, todas as partes de texto e glifo que ultrapassam o retângulo de formatação são cortadas. |
| NoFontFallback | 1024 | O fallback para fontes alternativas de caracteres sem suporte na fonte solicitada foi desabilitado. Os caracteres ausentes são exibidos com o glifo ausente de fontes, geralmente um quadrado aberto. |
| NoWrap | 4096 | Quebra de texto entre as linhas quando a formatação dentro de um retângulo é desabilitada. Esse sinalizador fica implícito quando um ponto é passado em vez de um retângulo ou quando o retângulo especificado tem um comprimento de linha zero. |
Exemplos
O exemplo de código a seguir demonstra os seguintes membros:
Este exemplo foi projetado para ser usado com 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 .
Observação
O campo FitBlackBox foi mal denominado e seu comportamento é semelhante ao NoFitBlackBox campo na implementação original do GDI+.
