TextFormatFlags Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica la información de diseño y de presentación de las cadenas de texto.
Esta enumeración admite una combinación bit a bit de sus valores de miembro.
public enum class TextFormatFlags
[System.Flags]
public enum TextFormatFlags
[<System.Flags>]
type TextFormatFlags =
Public Enum TextFormatFlags
- Herencia
- Atributos
Campos
Bottom | 8 | Alinea el texto en la parte inferior del rectángulo delimitador. Únicamente se aplica cuando el texto es sólo una línea. |
Default | 0 | Aplica el formato predeterminado: la alineación a la izquierda. |
EndEllipsis | 32768 | Quita el final de las líneas recortadas, que reemplaza con puntos suspensivos. Cuando se usa para dibujar texto por |
ExpandTabs | 64 | Expande los caracteres de tabulación. El número de caracteres predeterminado por tabulación es ocho. Los valores WordEllipsis, PathEllipsis y EndEllipsis no se pueden utilizar con ExpandTabs. |
ExternalLeading | 512 | Incluye la inicial externa de fuente en el alto de la línea. Normalmente, la inicial externa no está incluida en el alto de una línea de texto. |
GlyphOverhangPadding | 0 | Agrega relleno al rectángulo delimitador para alojar los glifos con partes que sobresalgan. Este es el valor predeterminado. |
HidePrefix | 1048576 | Omite el carácter de prefijo de y comercial (&) en el texto, de modo que la letra siguiente no se subrayado, pero se siguen procesando otros caracteres de prefijo mnemónico. |
HorizontalCenter | 1 | Centra horizontalmente el texto dentro del rectángulo delimitador. |
Internal | 4096 | Utiliza la fuente del sistema para calcular la métrica del texto. |
Left | 0 | Alinea el texto en el lado izquierdo del área recorte. Este es el valor predeterminado. |
LeftAndRightPadding | 536870912 | Agrega relleno a ambos lados del rectángulo delimitador. |
ModifyString | 65536 | No tiene ningún efecto en las medidas de texto o texto dibujadas. Cuando se usa para dibujar texto por |
NoClipping | 256 | Permite mostrar las partes de los glifos que sobresalgan y el texto no ajustado que se salga del rectángulo de formato. |
NoFullWidthCharacterBreak | 524288 | Valor heredado que no tiene ningún efecto. Impide un salto de línea en una cadena de caracteres de doble ancho, para que la regla de salto de línea sea equivalente a la de las cadenas de caracteres de ancho simple. |
NoPadding | 268435456 | No agrega relleno al rectángulo delimitador. |
NoPrefix | 2048 | Desactiva el procesamiento de caracteres de prefijo. Normalmente, el carácter de prefijo mnemónico (&) se interpreta como una directiva para resaltar el carácter siguiente, y los caracteres de prefijo mnemónico (&&) de doble amperado como una directiva para imprimir una sola y comercial. Este procesamiento se desactiva especificando NoPrefix. Por ejemplo, una cadena de entrada de "A&bc&&d" con NoPrefix aplicada daría como resultado la salida de "A&bc&&d". Compare con |
PathEllipsis | 16384 | Quita el centro de las líneas recortadas y lo reemplaza con puntos suspensivos. Cuando se usa para dibujar texto por |
PrefixOnly | 2097152 | Dibuja solo un subrayado en la posición del carácter que sigue al carácter de prefijo (&) y no dibuja ningún otro carácter de la cadena. |
PreserveGraphicsClipping | 16777216 | Conserva el recorte que especifica un objeto Graphics. Sólo se aplica a los métodos que reciben una interfaz IDeviceContext que es un objeto Graphics. |
PreserveGraphicsTranslateTransform | 33554432 | Conserva la transformación que especifica un objeto Graphics. Sólo se aplica a los métodos que reciben una interfaz IDeviceContext que es un objeto Graphics. |
Right | 2 | Alinea el texto en el lado derecho del área recorte. |
RightToLeft | 131072 | Muestra el texto de derecha a izquierda. |
SingleLine | 32 | Muestra el texto en una sola línea. |
TextBoxControl | 8192 | Especifica el texto al que se debe dar formato para presentarlo en un control TextBox. |
Top | 0 | Alinea el texto en la parte superior del rectángulo delimitador. Este es el valor predeterminado. |
VerticalCenter | 4 | Centra el texto verticalmente dentro del rectángulo delimitador. |
WordBreak | 16 | Provoca un salto del texto al final de una palabra. |
WordEllipsis | 262144 | Recorta la línea hasta la palabra más cercana y coloca puntos suspensivos al final de una línea recortada. Compárelo con EndEllipsis y PathEllipsis. |
Ejemplos
En el ejemplo siguiente se muestra cómo usar la TextFormatFlags
enumeración . Para ejecutar este ejemplo, pegue el código siguiente en un formulario Windows Forms. Llame RenderText6
desde el controlador de eventos del Paint formulario, pasando e
como PaintEventArgs.
private void RenderText6(PaintEventArgs e)
{
TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.EndEllipsis;
TextRenderer.DrawText(e.Graphics, "This is some text that will be clipped at the end.", this.Font,
new Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags);
}
Private Sub RenderText6(ByVal e As PaintEventArgs)
Dim flags As TextFormatFlags = TextFormatFlags.Bottom Or _
TextFormatFlags.EndEllipsis
TextRenderer.DrawText(e.Graphics, _
"This is some text that will be clipped at the end.", _
Me.Font, New Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags)
End Sub
Comentarios
La TextFormatFlags
enumeración la usa TextRenderer al dibujar y medir texto.
TextRenderer no admite la adición de posiciones de tabulación en texto dibujado, aunque es posible expandir las posiciones de tabulación existentes con la marca ExpandTabs
.