Valores de formato

En esta sección se enumeran los valores que se usan con el parámetro dwTextFlags de las funciones DrawThemeText y GetThemeTextExtent . Uno o varios de estos valores se usan para especificar cómo se debe dar formato a una cadena de texto. La función DrawThemeText dibujará la cadena de texto dentro de un rectángulo de presentación, especificado por el parámetro pRect . La función GetThemeTextExtent se puede usar para determinar el rectángulo delimitador necesario para el texto de una longitud y un formato concretos.

Valores de formato

En la tabla siguiente se enumeran los valores de formato.

Value	Descripción
DT_BOTTOM	Representa la cadena de texto en la parte inferior del rectángulo de presentación. Este valor solo se usa con el valor DT_SINGLELINE.
DT_CALCRECT	Determina el ancho y alto del rectángulo de presentación.
DT_CENTER	Centra el texto horizontalmente en el rectángulo de presentación.
DT_EDITCONTROL	Duplica las características que muestran texto de un control de edición de varias líneas. En concreto, el ancho medio de caracteres se calcula de la misma manera que para un control de edición y la función no muestra una última línea parcialmente visible.
DT_END_ELLIPSIS	Trunca una cadena de texto que es más ancha que el rectángulo de presentación y agrega puntos suspensivos para indicar el truncamiento. La cadena no se modifica a menos que se especifique la marca DT_MODIFYSTRING.
DT_EXPANDTABS	Expande los caracteres de tabulación. El número de caracteres predeterminado por tabulación es ocho. Los valores de DT_WORD_ELLIPSIS, DT_PATH_ELLIPSIS y DT_END_ELLIPSIS no se pueden usar con el valor de DT_EXPANDTABS.
DT_EXTERNALLEADING	Incluye la punta externa de una fuente en el alto de línea. Normalmente, la punta externa no se incluye en el alto de una línea de texto.
DT_HIDEPREFIX	Omite el carácter & de prefijo en el texto. La letra siguiente no está subrayada, pero se siguen procesando otros caracteres de prefijo. Por ejemplo: cadena de entrada: "A&bc&&d" normal: "Abc&d" DT_HIDEPREFIX: "Abc&d"
DT_LEFT	Alinea el texto a la izquierda.
DT_MODIFYSTRING	Modifica una cadena para que coincida con el texto mostrado. Este valor no tiene ningún efecto a menos que se especifique DT_END_ELLIPSIS o DT_PATH_ELLIPSIS.
DT_NOCLIP	Dibuja la cadena de texto sin recortar el rectángulo de presentación.
DT_NOFULLWIDTHCHARBREAK	Impide un salto de línea en un juego de caracteres de doble byte (DBCS), de modo que la regla de salto de línea sea equivalente al juego de caracteres de un solo byte (SBCS). Esto se puede usar, por ejemplo, para que las etiquetas de icono escritas en texto coreano sean más legibles. Este valor no tiene ningún efecto a menos que se especifique DT_WORDBREAK.
DT_NOPREFIX	Desactiva el procesamiento de caracteres de prefijo. Normalmente, DrawThemeText interpreta el carácter & de prefijo como una directiva para resaltar el carácter siguiente y los caracteres && de prefijo como una directiva para imprimir un único &. Al especificar DT_NOPREFIX, este procesamiento está desactivado. Por ejemplo: cadena de entrada: "A&bc&&d" normal: "Abc&d" DT_NOPREFIX: "A&bc&&d"
DT_PATH_ELLIPSIS	Reemplaza los caracteres del medio del texto por puntos suspensivos para que el resultado se ajuste al rectángulo de presentación. Si la cadena contiene caracteres de barra diagonal inversa (\), DT_PATH_ELLIPSIS conserva tanto como sea posible el texto después de la última barra diagonal inversa. La cadena no se modifica a menos que se especifique la marca DT_MODIFYSTRING.
DT_PREFIXONLY	Dibuja solo un subrayado en la posición del carácter que sigue al carácter &de prefijo . Normalmente DrawThemeText interpreta como & una directiva para resaltar el carácter que sigue y los caracteres && de prefijo como una directiva para imprimir un único &. Al especificar DT_PREFIXONLY, no se dibuja ningún carácter, solo un subrayado. Los espacios en blanco se colocan en las posiciones donde normalmente aparecerían los caracteres. Por ejemplo: cadena de entrada: "A&bc&&d" normal: "Abc&d DT_PREFIXONLY: " "
DT_RIGHT	Alinea el texto a la derecha.
DT_RTLREADING	Establece texto en orden de derecha a izquierda para texto bidireccional, por ejemplo, texto en una fuente hebreo o árabe. La dirección predeterminada para el texto es de izquierda a derecha.
DT_SINGLELINE	Muestra texto en una sola línea. Los retornos de carro y las fuentes de línea no rompen la línea.
DT_TABSTOP	Establece las tabulaciones.
DT_TOP	Representa el texto en la parte superior del rectángulo de presentación.
DT_VCENTER	Centra el texto verticalmente. Este valor solo se usa con el valor DT_SINGLELINE.
DT_WORDBREAK	Interrumpe las líneas entre palabras si una palabra se extendería más allá del borde del rectángulo de presentación. Una secuencia de retorno de carro/avance de línea (CR/LF) también interrumpe la línea.
DT_WORD_ELLIPSIS	Trunca cualquier palabra que no cabe en el rectángulo de presentación y agrega puntos suspensivos.