Especifica la información de diseño y de presentación de las cadenas de texto.
La enumeración tiene un atributo
FlagsAttribute
que permite una combinación bit a bit de los valores de miembro.
Espacio de nombres: System.Drawing
Ensamblado: System.Drawing (en system.drawing.dll)
Visual Basic (Declaración)
<FlagsAttribute> _
Public Enumeration StringFormatFlags
Dim instance As StringFormatFlags
[FlagsAttribute]
public enum StringFormatFlags
[FlagsAttribute]
public enum class StringFormatFlags
/** @attribute FlagsAttribute() */
public enum StringFormatFlags
FlagsAttribute
public enum StringFormatFlags
| | Nombre de miembro | Descripción |
|---|
| DirectionRightToLeft | El texto se muestra de derecha a izquierda. |
| DirectionVertical | El texto está alineado en sentido vertical. |
| DisplayFormatControl | Los caracteres de control, como la marca de texto de izquierda a derecha, se muestren en los resultados con un glifo que los representa. |
| FitBlackBox | Partes de los caracteres pueden sobresalir del rectángulo de diseño de la cadena. De forma predeterminada, los caracteres se cambian de posición para evitar que sobresalgan. |
| LineLimit | Sólo se disponen en el rectángulo de formato las líneas completas. 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. 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. 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. |
| MeasureTrailingSpaces | Incluye el espacio al final de cada línea. De manera predeterminada, el rectángulo delimitador que devuelve el método MeasureString excluye el espacio que hay al final de cada línea. Establezca este indicador para incluir dicho espacio en la medida. |
.gif) | NoClip | Las partes de glifos que sobresalgan y el texto no ajustado que se salga del rectángulo de formato se pueden mostrar. De manera predeterminada, se recortan todas las partes de texto y de glifos que sobresalgan del rectángulo de formato. |
| NoFontFallback | La reserva de fuentes alternativas para los caracteres que no admita la fuente solicitada queda deshabilitada. Los caracteres que falten se muestran con el glifo de ausencia de fuente, normalmente un cuadrado abierto. |
| NoWrap | El ajuste del texto entre las líneas cuando al dar formato dentro de un rectángulo está deshabilitado. Este indicador 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. |
La clase StringFormat utiliza StringFormatFlags.
.gif) Nota |
|---|
| El nombre dado al campo FitBlackBox no es adecuado y su comportamiento es similar al del campo NoFitBlackBox en la implementación de GDI+ original. |
En este ejemplo de código se muestran los siguientes miembros:
Este ejemplo se aplica a un formulario Windows Forms. Pegue el código en un formulario y llame al método ShowLineAndAlignment cuando controle el evento Paint del formulario, pasando e como PaintEventArgs.
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
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:
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.set_LineAlignment(StringAlignment.Near);
format1.set_Alignment(StringAlignment.Center);
format2.set_LineAlignment(StringAlignment.Center);
format2.set_Alignment(StringAlignment.Far);
// Draw the bounding rectangle and a string for each
// StringFormat object.
e.get_Graphics().DrawRectangle(Pens.get_Black(), displayRectangle);
e.get_Graphics().DrawString("Showing Format1", this.get_Font(),
Brushes.get_Red(), (RectangleF.op_Implicit((displayRectangle))),
format1);
e.get_Graphics().DrawString("Showing Format2", this.get_Font(),
Brushes.get_Red(), RectangleF.op_Implicit((displayRectangle)),
format2);
} //ShowLineAndAlignment
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
.NET Framework
Compatible con: 2.0, 1.1, 1.0
.NET Compact Framework
Compatible con: 2.0