StringFormatFlags Enumeração

Definição

Especifica as informações de layout e de exibição para cadeias de caracteres de texto.Specifies the display and layout information for text strings.

Esta enumeração tem um atributo FlagsAttribute que permite uma combinação bit a bit dos seus valores membros.

public enum class StringFormatFlags
[System.Flags]
public enum StringFormatFlags
type StringFormatFlags = 
Public Enum StringFormatFlags
Herança
StringFormatFlags
Atributos

Campos

DirectionRightToLeft 1

O texto é exibido da direita para a esquerda.Text is displayed from right to left.

DirectionVertical 2

O texto é alinhado verticalmente.Text is vertically aligned.

DisplayFormatControl 32

Caracteres de controle, como a marca da esquerda para a direita, são mostrados na saída com um glifo representativo.Control characters such as the left-to-right mark are shown in the output with a representative glyph.

FitBlackBox 4

Partes de caracteres têm permissão para criar uma folga no retângulo do layout da cadeia de caracteres.Parts of characters are allowed to overhang the string's layout rectangle. Por padrão, os caracteres são reposicionados para evitar qualquer folga.By default, characters are repositioned to avoid any overhang.

LineLimit 8192

Somente linhas inteiras ficam dispostas no retângulo de formatação.Only entire lines are laid out in the formatting rectangle. 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.By default layout continues until the end of the text, or until no more lines are visible as a result of clipping, whichever comes first. 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.Note that the default settings allow the last line to be partially obscured by a formatting rectangle that is not a whole multiple of the line height. 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.To ensure that only whole lines are seen, specify this value and be careful to provide a formatting rectangle at least as tall as the height of one line.

MeasureTrailingSpaces 2048

Inclui o espaço à direita no final de cada linha.Includes the trailing space at the end of each line. Por padrão, o retângulo limite retornado pelo método MeasureString exclui o espaço no final de cada linha.By default the boundary rectangle returned by the MeasureString method excludes the space at the end of each line. Defina esse sinalizador para incluir esse espaço na medida.Set this flag to include that space in measurement.

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.Overhanging parts of glyphs, and unwrapped text reaching outside the formatting rectangle are allowed to show. Por padrão, todas as partes de texto e glifo que ultrapassam o retângulo de formatação são cortadas.By default all text and glyph parts reaching outside the formatting rectangle are clipped.

NoFontFallback 1024

O fallback para fontes alternativas de caracteres sem suporte na fonte solicitada foi desabilitado.Fallback to alternate fonts for characters not supported in the requested font is disabled. Os caracteres ausentes são exibidos com o glifo ausente de fontes, geralmente um quadrado aberto.Any missing characters are displayed with the fonts missing glyph, usually an open square.

NoWrap 4096

Quebra de texto entre as linhas quando a formatação dentro de um retângulo é desabilitada.Text wrapping between lines when formatting within a rectangle is disabled. 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.This flag is implied when a point is passed instead of a rectangle, or when the specified rectangle has a zero line length.

Exemplos

O exemplo de código a seguir demonstra os seguintes membros:The following code example demonstrates the following members:

Este exemplo foi projetado para ser usado com Windows Forms.This example is designed to be used with Windows Forms. Cole o código em um formulário e chame o método ShowLineAndAlignment ao manipular o evento Paint do formulário, passando e como PaintEventArgs.Paste the code into a form and call the ShowLineAndAlignment method when handling the form's Paint event, passing e as 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 classe StringFormat.StringFormatFlags is used by the StringFormat class.

Observação

O campo FitBlackBox foi nomeado indiferentemente e seu comportamento é semelhante ao campo NoFitBlackBox na implementação original do GDI+.The FitBlackBox field was misnamed and its behavior is similar to the NoFitBlackBox field in the original GDI+ implementation.

Aplica-se a