Enumeración StringFormatFlags (gdiplusenums.h)

Artículo
02/28/2024

La enumeración StringFormatFlags especifica información de diseño de texto (como orientación y recorte) y manipulaciones de visualización (como la inserción de puntos suspensivos, la sustitución de dígitos y la representación de caracteres que no son compatibles con una fuente).

Syntax

typedef enum StringFormatFlags {
  StringFormatFlagsDirectionRightToLeft = 0x00000001,
  StringFormatFlagsDirectionVertical = 0x00000002,
  StringFormatFlagsNoFitBlackBox = 0x00000004,
  StringFormatFlagsDisplayFormatControl = 0x00000020,
  StringFormatFlagsNoFontFallback = 0x00000400,
  StringFormatFlagsMeasureTrailingSpaces = 0x00000800,
  StringFormatFlagsNoWrap = 0x00001000,
  StringFormatFlagsLineLimit = 0x00002000,
  StringFormatFlagsNoClip = 0x00004000,
  StringFormatFlagsBypassGDI = 0x80000000
} ;

Constantes


`StringFormatFlagsDirectionRightToLeft` Valor: 0x00000001 Especifica que el orden de lectura es de derecha a izquierda. En el caso del texto horizontal, los caracteres se leen de derecha a izquierda. En el caso del texto vertical, las columnas se leen de derecha a izquierda. De forma predeterminada, el texto horizontal o vertical se lee de izquierda a derecha.
`StringFormatFlagsDirectionVertical` Valor: 0x00000002 Especifica que las líneas de texto individuales se dibujan verticalmente en el dispositivo de visualización. De forma predeterminada, las líneas de texto son horizontales, cada nueva línea debajo de la línea anterior.
`StringFormatFlagsNoFitBlackBox` Valor: 0x00000004 Especifica que se permite que partes de caracteres sobresalgan el rectángulo de diseño de la cadena. De forma predeterminada, los caracteres se alinean primero dentro de los límites del rectángulo y, a continuación, los caracteres que todavía sobresalgan los límites se vuelven a colocar para evitar cualquier voladizo y, por lo tanto, evitar que afecte a los píxeles fuera del rectángulo de diseño. Una letra en minúsculas F (f) cursiva es un ejemplo de un carácter que puede tener partes salientes. Establecer esta marca garantiza que el carácter se alinea visualmente con las líneas anteriores y inferiores, pero puede hacer que partes de caracteres, que se encuentran fuera del rectángulo de diseño, se recorten o pinteen.
`StringFormatFlagsDisplayFormatControl` Valor: 0x00000020 Especifica que los caracteres de control de diseño Unicode se muestran con un carácter representativo.
`StringFormatFlagsNoFontFallback` Valor: 0x00000400 Especifica que se usa una fuente alternativa para caracteres que no se admiten en la fuente solicitada. De forma predeterminada, los caracteres que faltan se muestran con el carácter "fuentes que faltan", normalmente un cuadrado abierto.
`StringFormatFlagsMeasureTrailingSpaces` Valor: 0x00000800 Especifica que el espacio al final de cada línea se incluye en una medida de cadena. De forma predeterminada, el rectángulo de límite devuelto por El método Graphics::MeasureString excluye el espacio al final de cada línea. Establezca esta marca para incluir ese espacio en la medida.
`StringFormatFlagsNoWrap` Valor: 0x00001000 Especifica que el ajuste del texto a la siguiente línea está deshabilitado. NoWrap está implícito cuando se usa un punto de origen en lugar de un rectángulo de diseño. Cuando se dibuja texto dentro de un rectángulo, de forma predeterminada, el texto se interrumpe en el último límite de palabra que está dentro del límite del rectángulo y se ajusta a la siguiente línea.
`StringFormatFlagsLineLimit` Valor: 0x00002000 Especifica que solo se disponen líneas completas en el rectángulo de diseño. De forma predeterminada, el diseño continúa hasta el final del texto o hasta que no haya más líneas visibles como resultado del recorte, lo que ocurra primero. La configuración predeterminada permite que la última línea se oscurezca parcialmente mediante un rectángulo de diseño que no es un múltiplo completo del alto de línea. Para asegurarse de que solo se ven líneas completas, establezca esta marca y tenga cuidado de proporcionar un rectángulo de diseño al menos tan alto como alto de una línea.
`StringFormatFlagsNoClip` Valor: 0x00004000 Especifica que los caracteres que sobresalgan el rectángulo de diseño y el texto que se extienden fuera del rectángulo de diseño pueden mostrarse. De forma predeterminada, se recortan todos los caracteres y texto que se extienden fuera del rectángulo de diseño. Se recortan los espacios finales (espacios que están al final de una línea) que se extienden fuera del rectángulo de diseño. Por lo tanto, la configuración de esta marca tendrá un efecto en una medida de cadena si los espacios finales se incluyen en la medida. Si el recorte está habilitado, los espacios finales que se extienden fuera del rectángulo de diseño no se incluyen en la medida. Si el recorte está deshabilitado, todos los espacios finales se incluyen en la medida, independientemente de si están fuera del rectángulo de diseño.
`StringFormatFlagsBypassGDI` Valor: 0x80000000

Comentarios

Varios conjuntos de marcas pueden producir efectos combinados:

Cuando se establecen stringFormatFlagsDirectionVertical y StringFormatFlagsDirectionRightToLeft , las líneas de texto individuales se dibujan verticalmente. La primera línea comienza en el borde derecho del rectángulo de diseño; la segunda línea de texto está a la izquierda de la primera línea, etc.
Cuando StringFormatFlagsDirectionVertical se establece y StringFormatFlagsDirectionRightToLeft no se establece, las líneas de texto individuales se dibujan verticalmente. La primera línea comienza en el borde izquierdo del rectángulo de diseño; la segunda línea de texto está a la derecha de la primera línea.
Cuando StringFormatFlagsDirectionRightToLeft se establece y StringFormatFlagsDirectionVertical no se establece, las líneas individuales de texto son horizontales y el orden de lectura va de derecha a izquierda. Esta configuración no cambia el orden en el que se muestran los caracteres, simplemente especifica el orden en el que se pueden leer los caracteres.

Las marcas StringFormatFlagsDirectionVertical y StringFormatFlagsDirectionRightToLeft pueden afectar a la alineación de cadenas.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	gdiplusenums.h (include Gdiplus.h)