Comparación de Text API de Win32
Para aquellos desarrolladores que migran su código de aplicación Win32, en la tabla siguiente se enumeran las API de texto de Win32 y el equivalente aproximado en DirectWrite.
| Llamadas de texto GDI | Descripción | DirectWrite equivalente |
|---|---|---|
| AddFontMemResourceEx | Agrega una fuente incrustada a la tabla de fuentes del sistema. | CreateCustomFontFileReference + CreateCustomFontCollection |
| AddFontResource | Agrega un recurso de fuente a la tabla de fuentes del sistema. | No hay equivalente. AddFontResource agrega a la colección de fuentes del sistema como parte del paso de instalación de fuentes GDI. DirectWrite rellena la colección de fuentes del sistema por adelantado y supervisa automáticamente las actualizaciones, por lo que nunca se necesita ninguna instalación. |
| AddFontResourceEx | Agrega una fuente privada o no enumerable a la tabla de fuentes del sistema. | Lo mismo que antes. |
| CreateFont | Crea una fuente lógica. | En lugar de la fuente lógica, las aplicaciones pueden especificar un conjunto de propiedades de fuente (por ejemplo, nombre de familia, peso, estilo, stretch y tamaño) para crear un IDWriteTextFormat. Solo las aplicaciones que requieran enumeración de la fuente tendrán acceso a IDWriteFont a través de IDWriteFontCollection. |
| CreateFontIndirect | Crea una fuente lógica a partir de una estructura. | Lo mismo que antes. |
| CreateFontIndirectEx | Crea una fuente lógica a partir de una estructura. | Lo mismo que antes. |
| Drawtext | Dibuja texto con formato en un rectángulo. | IDWriteTextLayout::D raw |
| DrawTextEx | Dibuja texto con formato en un rectángulo. | IDWriteTextLayout::D raw |
| EnumFontFamExProc | Función de devolución de llamada definida por la aplicación que se usa con EnumFontFamiliesEx para procesar fuentes. | Interfaz IDWriteFontCollection , a través de IDWriteFactory::GetSystemFontCollection |
| EnumFontFamiliesEx | Enumera todas las fuentes del sistema con determinadas características. | Interfaz IDWriteFontCollection , a través de IDWriteFactory::GetSystemFontCollection |
| ExtTextOut | Dibuja una cadena de caracteres. | IDWriteTextLayout::D raw o IDWriteRenderBitmapTarget::D rawGlyphRun |
| GetAspectRatioFilterEx | Obtiene la configuración del filtro de relación de aspecto. | N/D |
| GetCharABCWidths | Obtiene los anchos de caracteres consecutivos de la fuente TrueType. | IDWriteFontFace::GetDesignGlyphMetrics |
| GetCharABCWidthsFloat | Obtiene los anchos de caracteres consecutivos de la fuente actual. | IDWriteFontFace::GetDesignGlyphMetrics |
| GetCharABCWidthsI | Obtiene los anchos de índices de glifo consecutivos o una matriz de índices de glifo de la fuente TrueType. | IDWriteFontFace::GetDesignGlyphMetrics |
| GetCharacterPlacement | Obtiene información sobre una cadena de caracteres. | IDWriteTextAnalyzer |
| GetCharWidth32 | Obtiene los anchos de caracteres consecutivos de la fuente actual. | IDWriteFontFace::GetDesignGlyphMetrics o IDWriteTextLayout::GetMetrics |
| GetCharWidthFloat | Obtiene los anchos fraccionarios de caracteres consecutivos de la fuente actual. | IDWriteFontFace::GetDesignGlyphMetrics o IDWriteTextLayout::GetMetrics |
| GetCharWidthI | Obtiene los anchos de índices de glifo consecutivos o una matriz de índices de glifo de la fuente actual. | IDWriteFontFace::GetDesignGlyphMetrics o IDWriteTextLayout::GetMetrics |
| GetFontData | Obtiene datos de métricas para una fuente TrueType. | IDWriteFontFace::TryGetFontTable |
| GetFontLanguageInfo | Devuelve información sobre la fuente seleccionada para un contexto de presentación. | N/D |
| GetFontUnicodeRanges | Indica qué caracteres Unicode son compatibles con una fuente. | bucle de IDWriteFont::HasCharacter |
| GetGlyphIndices | Convierte una cadena en una matriz de índices de glifos. | IDWriteFontFace::GetGlyphIndices |
| GetGlyphOutline | Obtiene el esquema o mapa de bits de un carácter en la fuente TrueType. | Métricas de glifo: IDWriteFontFace::GetDesignGlyphMetrics, información de esquema real --IDwriteFontFace::GetGlyphRunOutline, si desea mapas de bits de glifo, IDWriteRenderBitmapRenderTarget::D rawGlyphRun |
| GetKerningPairs | Obtiene los pares de inter kerning de caracteres para una fuente. | Kerning permitido a través de propiedades tipográficas del diseño (DirectWrite realiza el inter kerning en sí, por lo que no hay ningún método para devolver esta información). |
| GetOutlineTextMetrics | Obtiene métricas de texto para fuentes TrueType. | IDWriteFontFace::GetMetrics |
| GetRasterizerCaps | Indica si las fuentes TrueType están instaladas. | (Las fuentes TrueType se instalan en Windows Vista y Windows 7 de forma predeterminada). |
| GetTabbedTextExtent | Calcula el ancho y el alto de una cadena de caracteres, incluidas las pestañas. | IDWriteTextLayout::GetMetrics |
| GetTextAlign | Obtiene la configuración de alineación de texto para un contexto de dispositivo. | IDWriteTextFormat::GetTextAlignment |
| GetTextCharacterExtra | Obtiene el espaciado entre caracteres actual para un contexto de dispositivo. | N/D |
| GetTextColor | Obtiene el color de texto de un contexto de dispositivo. | N/D (DirectWrite es independiente de la representación y, por tanto, no conoce el color. Las aplicaciones deben realizar un seguimiento de ella en sí mismas). |
| GetTextExtentExPoint | Obtiene el número de caracteres de una cadena que caberá dentro de un espacio. | IDWriteTextLayout::GetMetrics |
| GetTextExtentExPointI | Obtiene el número de índices de glifo que caberán dentro de un espacio. | IDWriteTextLayout::GetMetrics |
| GetTextExtentPoint32 | Calcula el ancho y el alto de una cadena de texto. | IDWriteTextLayout::GetMetrics |
| GetTextExtentPointI | Calcula el ancho y el alto de una matriz de índices de glifo. | IDWriteTextLayout::GetMetrics |
| GetTextFace | Obtiene el nombre de la fuente seleccionada en un contexto de dispositivo. | IDWriteFont::GetFaceNames (Devuelve todos los nombres) |
| GetTextMetrics | Rellena un búfer con las métricas de una fuente. | IDWriteFontFace::GetMetrics |
| PolyTextOut | Dibuja varias cadenas con los colores de fuente y texto en un contexto de dispositivo. | N/A; crear varios objetos de diseño |
| RemoveFontMemResourceEx | Quita una fuente cuyo origen se insertó en un documento de la tabla de fuentes del sistema. | IUnknown::Release en el objeto asociado |
| RemoveFontResource | Quita las fuentes de un archivo de la tabla de fuentes del sistema. | N/D |
| RemoveFontResourceEx | Quita una fuente privada o no enumerable de la tabla de fuentes del sistema. | N/D |
| SetMapperFlags | Modifica el algoritmo utilizado para asignar fuentes lógicas a fuentes físicas. | N/D |
| SetTextAlign | Establece las marcas de alineación de texto para un contexto de dispositivo. | IDWriteTextFormat::SetTextAlignment |
| SetTextCharacterExtra | Establece el espaciado entre caracteres. | N/D |
| SetTextColor | Establece el color de texto de un contexto de dispositivo. | Una aplicación tiene que encargarse de especificar el color en una de las llamadas a Draw . |
| SetTextJustification | Especifica la cantidad de espacio que el sistema debe agregar a los caracteres de interrupción de una cadena. | N/D La justificación y el espaciado de caracteres no se admiten en esta versión. |
| TabbedTextOut | Escribe una cadena de caracteres en una ubicación y expande pestañas en valores especificados. | IDWriteTextLayout::D raw |
| TextOut | Escribe una cadena de caracteres en una ubicación | IDWriteTextLayout::D raw |