StringFormatFlags Enumeração

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

StringFormatFlags.cs

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

Object

ValueType

Enum

StringFormatFlags

Atributos

FlagsAttribute

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:

• Rectangle

• StringFormat

• StringFormat

• Alignment

• LineAlignment

• StringAlignment

• StringFormatFlags

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+.