StringFormatFlags Enumeración

Definición

Espacio de nombres:
System.Drawing
Ensamblado:
System.Drawing.dll

Especifica la información de presentación y diseño de las cadenas de texto.

Esta enumeración admite una combinación bit a bit de sus valores de miembro.

public enum class StringFormatFlags
[System.Flags]
public enum StringFormatFlags
[<System.Flags>]
type StringFormatFlags = 
Public Enum StringFormatFlags
Herencia
Object
ValueType
Enum
StringFormatFlags
Atributos
FlagsAttribute

Campos

Nombre Valor Description
DirectionRightToLeft 1

El texto se muestra de derecha a izquierda.
DirectionVertical 2

El texto está alineado verticalmente.
FitBlackBox 4

Se permite que partes de caracteres sobresalgan el rectángulo de diseño de la cadena. De forma predeterminada, los caracteres se cambian de posición para evitar que se supere el voladizo.
DisplayFormatControl 32

Los caracteres de control, como la marca izquierda a derecha, se muestran en la salida con un glifo representativo.
NoFontFallback 1024

La reserva a fuentes alternativas para caracteres no admitidos en la fuente solicitada está deshabilitada. Los caracteres que faltan se muestran con las fuentes que faltan glifos, normalmente un cuadrado abierto.
MeasureTrailingSpaces 2048

Incluye el espacio final al final de cada línea. De forma predeterminada, el rectángulo de límite devuelto por el MeasureString método excluye el espacio al final de cada línea. Establezca esta marca para incluir ese espacio en la medida.
NoWrap 4096

El ajuste de texto entre líneas cuando se deshabilita el formato dentro de un rectángulo. Esta marca está implícita cuando se pasa un punto en lugar de un rectángulo, o cuando el rectángulo especificado tiene una longitud de línea cero.
LineLimit 8192

Solo se disponen líneas completas en el rectángulo de formato. De forma predeterminada, el diseño continúa hasta el final del texto o hasta que no haya más líneas visibles como resultado del recorte, lo que ocurra primero. Tenga en cuenta que la configuración predeterminada permite que la última línea se oscurezca parcialmente mediante un rectángulo de formato que no sea un múltiplo completo del alto de línea. Para asegurarse de que solo se ven líneas completas, especifique este valor y tenga cuidado de proporcionar un rectángulo de formato al menos tan alto como alto de una línea.
NoClip 16384

Se permite que se muestren partes de glifos y texto desencapsulado que llega fuera del rectángulo de formato. De forma predeterminada, se recortan todas las partes de texto y glifo que llegan fuera del rectángulo de formato.

Ejemplos

En el ejemplo de código siguiente se muestran los siguientes miembros:

Este ejemplo está diseñado para usarse con Windows Forms. Pegue el código en un formulario y llame al ShowLineAndAlignment método al controlar el evento del Paint formulario, pasando 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

Comentarios

StringFormatFlags la usa la StringFormat clase .

Note

El campo FitBlackBox se ha llamado mal y su comportamiento es similar al NoFitBlackBox campo en la implementación de GDI+ original.

Se aplica a