StringFormatFlags StringFormatFlags StringFormatFlags StringFormatFlags Enum

Definición

Especifica la información de diseño y de presentación de las cadenas de texto.Specifies the display and layout information for text strings.

Esta enumeración tiene el atributo FlagsAttribute, que permite una combinación bit a bit de sus valores de miembro.

public enum class StringFormatFlags
[System.Flags]
public enum StringFormatFlags
type StringFormatFlags = 
Public Enum StringFormatFlags
Herencia
StringFormatFlagsStringFormatFlagsStringFormatFlagsStringFormatFlags
Atributos

Campos

DirectionRightToLeft DirectionRightToLeft DirectionRightToLeft DirectionRightToLeft 1

El texto se muestra de derecha a izquierda.Text is displayed from right to left.

DirectionVertical DirectionVertical DirectionVertical DirectionVertical 2

El texto está alineado en sentido vertical.Text is vertically aligned.

DisplayFormatControl DisplayFormatControl DisplayFormatControl DisplayFormatControl 32

Los caracteres de control, como la marca de texto de izquierda a derecha, se muestren en los resultados con un glifo que los representa.Control characters such as the left-to-right mark are shown in the output with a representative glyph.

FitBlackBox FitBlackBox FitBlackBox FitBlackBox 4

Partes de los caracteres pueden sobresalir del rectángulo de diseño de la cadena.Parts of characters are allowed to overhang the string's layout rectangle. De forma predeterminada, los caracteres se cambian de posición para evitar que sobresalgan.By default, characters are repositioned to avoid any overhang.

LineLimit LineLimit LineLimit LineLimit 8192

Sólo se disponen en el rectángulo de formato las líneas completas.Only entire lines are laid out in the formatting rectangle. De manera predeterminada, el diseño continúa hasta el final del texto o hasta que no haya más líneas visibles como consecuencia del recorte, lo que suceda primero.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. Tenga en cuenta que la configuración predeterminada permite que la última línea quede parcialmente tapada por un rectángulo que no sea un múltiplo entero del alto de la línea.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 garantizar que sólo se ven líneas completas, especifique este valor y asegúrese de proporcionar un rectángulo de formato que sea al menos tan alto como el alto de una línea.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 MeasureTrailingSpaces MeasureTrailingSpaces MeasureTrailingSpaces 2048

Incluye el espacio al final de cada línea.Includes the trailing space at the end of each line. De manera predeterminada, el rectángulo delimitador que devuelve el método MeasureString excluye el espacio que hay al final de cada línea.By default the boundary rectangle returned by the MeasureString method excludes the space at the end of each line. Establezca este marcador para incluir dicho espacio en la medida.Set this flag to include that space in measurement.

NoClip NoClip NoClip NoClip 16384

Las partes de glifos que sobresalgan y el texto no ajustado que se salga del rectángulo de formato se pueden mostrar.Overhanging parts of glyphs, and unwrapped text reaching outside the formatting rectangle are allowed to show. De manera predeterminada, se recortan todas las partes de texto y de glifos que sobresalgan del rectángulo de formato.By default all text and glyph parts reaching outside the formatting rectangle are clipped.

NoFontFallback NoFontFallback NoFontFallback NoFontFallback 1024

La reserva de fuentes alternativas para los caracteres que no admita la fuente solicitada queda deshabilitada.Fallback to alternate fonts for characters not supported in the requested font is disabled. Los caracteres que falten se muestran con el glifo de ausencia de fuente, normalmente un cuadrado abierto.Any missing characters are displayed with the fonts missing glyph, usually an open square.

NoWrap NoWrap NoWrap NoWrap 4096

El ajuste del texto entre las líneas cuando al dar formato dentro de un rectángulo está deshabilitado.Text wrapping between lines when formatting within a rectangle is disabled. Este marcador es implícito si se pasa un punto en lugar de un rectángulo o si el rectángulo especificado tiene una longitud de línea de cero.This flag is implied when a point is passed instead of a rectangle, or when the specified rectangle has a zero line length.

Ejemplos

El ejemplo de código siguiente muestra a los miembros siguientes:The following code example demonstrates the following members:

En este ejemplo está diseñado para usarse con Windows Forms.This example is designed to be used with Windows Forms. Pegue el código en un formulario y llame a la ShowLineAndAlignment método cuando el control del formulario Paint evento pasando 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

Comentarios

StringFormatFlags está usando el StringFormat clase.StringFormatFlags is used by the StringFormat class.

Nota

El campo FitBlackBox es adecuado y su comportamiento es similar a la NoFitBlackBox campo en la implementación original de GDI +.The FitBlackBox field was misnamed and its behavior is similar to the NoFitBlackBox field in the original GDI+ implementation.

Se aplica a