TextFormatFlags (Enumeración) (System.Windows.Forms)

Cambiar vista:

Clásica

Ligera

Sin script

Comentario del sitio

Biblioteca de clases de .NET Framework

TextFormatFlags (Enumeración)

Actualización: noviembre 2007

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

Esta enumeración tiene un atributo FlagsAttribute que permite una combinación bit a bit de los valores de miembro.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en System.Windows.Forms.dll)

Sintaxis

Visual Basic (Declaración)

<FlagsAttribute> _
Public Enumeration TextFormatFlags

Visual Basic (Uso)

Dim instance As TextFormatFlags

[FlagsAttribute]
public enum TextFormatFlags

Visual C++

[FlagsAttribute]
public enum class TextFormatFlags

/** @attribute FlagsAttribute */
public enum TextFormatFlags

JScript

public enum TextFormatFlags

Miembros

	Nombre de miembro	Descripción
	Bottom	Alinea el texto en la parte inferior del rectángulo delimitador. Únicamente se aplica cuando el texto es sólo una línea.
	EndEllipsis	Quita el final de las líneas recortadas, que reemplaza con puntos suspensivos.
	ExpandTabs	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	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.
	Default	Aplica el formato predeterminado: la alineación a la izquierda.
	HidePrefix	Sólo se aplica a Windows 2000 y Windows XP:
	HorizontalCenter	Centra horizontalmente el texto dentro del rectángulo delimitador.
	Internal	Utiliza la fuente del sistema para calcular la métrica del texto.
	Left	Alinea el texto en el lado izquierdo del área recorte.
	ModifyString	No tiene ningún efecto en el texto dibujado.
	NoClipping	Permite mostrar las partes de los glifos que sobresalgan y el texto no ajustado que se salga del rectángulo de formato.
	NoPrefix	Desactiva el procesamiento de caracteres de prefijo. Normalmente, el carácter y comercial (&) de prefijo de tecla de acceso se interpreta como una directiva para subrayar el carácter que lo sigue, y cuando aparecen dos caracteres y comercial (&&) de prefijo de tecla de acceso seguidos se interpretan como una directiva para imprimir una sola y comercial. Este procesamiento se desactiva especificando NoPrefix. Por ejemplo, una cadena de entrada "A&bc&&d" a la que se aplique NoPrefix tendrá como resultado "A&bc&&d".
	NoFullWidthCharacterBreak	Sólo se aplica a Windows 98, Windows Me, Windows 2000 y Windows XP:
	PathEllipsis	Quita el centro de las líneas recortadas y lo reemplaza con puntos suspensivos.
	PrefixOnly	Sólo se aplica a Windows 2000 y Windows XP:
	Right	Alinea el texto en el lado derecho del área recorte.
	RightToLeft	Muestra el texto de derecha a izquierda.
	SingleLine	Muestra el texto en una sola línea.
	TextBoxControl	Especifica el texto al que se debe dar formato para presentarlo en un control TextBox.
	Top	Alinea el texto en la parte superior del rectángulo delimitador.
	VerticalCenter	Centra el texto verticalmente dentro del rectángulo delimitador.
	WordBreak	Provoca un salto del texto al final de una palabra.
	WordEllipsis	Recorta la línea hasta la palabra más cercana y coloca puntos suspensivos al final de una línea recortada.
	PreserveGraphicsClipping	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	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.
	GlyphOverhangPadding	Agrega relleno al rectángulo delimitador para alojar los glifos con partes que sobresalgan.
	NoPadding	No agrega relleno al rectángulo delimitador.
	LeftAndRightPadding	Agrega relleno a ambos lados del rectángulo delimitador.

Comentarios

TextRenderer utiliza la enumeración TextFormatFlags para trazar y medir texto. TextRenderer no permite agregar posiciones de tabulación para trazar texto, aunque puede ampliar las posiciones de tabulación existentes mediante el marcador ExpandTabs.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la enumeración TextFormatFlags. Para ejecutar este ejemplo, pegue el siguiente código en un formulario Windows Forms. Llame a RenderText6 desde el controlador de eventos Paint del formulario, pasando e como PaintEventArgs.

Visual Basic

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

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);
}

Plataformas

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión

.NET Framework

Compatible con: 3.5, 3.0, 2.0

Vea también

Referencia

System.Windows.Forms (Espacio de nombres)

Otros recursos

Utilizar fuentes y texto