共用方式為

Win32 文字 API 比較

對於正在移轉其 Win32 應用程式程式代碼的開發人員，下表列出 Win32 文字 API 和 DirectWrite 中的近似對等專案。

GDI 文字呼叫 描述 DirectWrite 對等專案
AddFontMemResourceEx 將內嵌字型新增至系統字型表格。 CreateCustomFontFileReference + CreateCustomFontCollection
AddFontResource 將字型資源新增至系統字型表格。 沒有對等專案。 AddFontResource 新增至系統字型集合，作為 GDI 字型安裝步驟的一部分。 DirectWrite 會預先填入系統字型集合，並自動監視更新，因此不需要安裝。
AddFontResourceEx 將私用或不可列舉的字型新增至系統字型表格。 與上述相同
CreateFont 建立邏輯字型。 應用程式可以指定一組字型屬性（例如系列名稱、粗細、樣式、延展和大小），以建立 IDWriteTextFormat。 只有需要列舉字型的應用程式會透過 IDWriteFontCollection存取 IDWriteFont。
CreateFontIndirect 從結構建立邏輯字型。 與上述相同
CreateFontIndirectEx 從結構建立邏輯字型。 與上述相同
DrawText 在矩形中繪製格式化的文字。 IDWriteTextLayout：:D raw
DrawTextEx 在矩形中繪製格式化的文字。 IDWriteTextLayout：:D raw
EnumFontFamExProc 搭配 EnumFontFamiliesEx 來處理字型的應用程式定義回呼函式。 IDWriteFontCollection 介面，透過 IDWriteFactory：：GetSystemFontCollection
EnumFontFamiliesEx 列舉系統中具有特定特性的所有字型。 IDWriteFontCollection 介面，透過 IDWriteFactory：：GetSystemFontCollection
ExtTextOut 繪製字元字串。 IDWriteTextLayout：:D raw 或 IDWriteRenderBitmapTarget：:D rawGlyphRun
GetAspectRatioFilterEx 取得外觀比例篩選的設定。 N/A
GetCharABCWidths 從 TrueType 字型取得連續字元的寬度。 IDWriteFontFace：：GetDesignGlyphMetrics
GetCharABCWidthsFloat 從目前字型取得連續字元的寬度。 IDWriteFontFace：：GetDesignGlyphMetrics
GetCharABCWidthsI 從 TrueType 字型取得連續圖像索引的寬度或字元索引數位。 IDWriteFontFace：：GetDesignGlyphMetrics
GetCharacterPlacement 取得字元字串的相關信息。 IDWriteTextAnalyzer
GetCharWidth32 從目前字型取得連續字元的寬度。 IDWriteFontFace：：GetDesignGlyphMetrics 或 IDWriteTextLayout：：GetMetrics
GetCharWidthFloat 從目前字型取得連續字元的小數寬度。 IDWriteFontFace：：GetDesignGlyphMetrics 或 IDWriteTextLayout：：GetMetrics
GetCharWidthI 從目前字型取得連續圖像索引的寬度或圖像索引數位。 IDWriteFontFace：：GetDesignGlyphMetrics 或 IDWriteTextLayout：：GetMetrics
GetFontData 取得 TrueType 字型的計量數據。 IDWriteFontFace：：TryGetFontTable
GetFontLanguageInfo 傳回顯示內容所選取字型的相關信息。 N/A
GetFontUnicodeRanges 指出字型支援哪些 Unicode 字元。 idWriteFont：：HasCharacter的迴圈
GetGlyphIndices 將字串轉譯成字元索引陣列。 IDWriteFontFace：：GetGlyphIndices
GetGlyphOutline 取得 TrueType 字型中字元的外框或點陣圖。 glyph 計量 -- IDWriteFontFace：：GetDesignGlyphMetrics，實際大綱資訊 --IDwriteFontFace：：GetGlyphRunOutline，如果您想要圖像位圖，IDWriteRenderBitmapRenderTarget：:D rawGlyphRun
GetKerningPairs 取得字型的字元字距字組。 透過版面配置印刷屬性允許的 Kerning （DirectWrite 會自行進行 Kerning，因此沒有傳回此資訊的方法）。
GetOutlineTextMetrics 取得 TrueType 字型的文字計量。 IDWriteFontFace：：GetMetrics
GetRasterizerCaps 指出是否已安裝 TrueType 字型。 （TrueType 字型預設安裝在 Windows Vista 和 Windows 7 上。
GetTabbedTextExtent 計算字元字串的寬度和高度，包括索引標籤。 IDWriteTextLayout：：GetMetrics
GetTextAlign 取得裝置內容的文字對齊設定。 IDWriteTextFormat：：GetTextAlignment
GetTextCharacterExtra 取得裝置內容的目前字元間距。 N/A
GetTextColor 取得裝置內容的文字色彩。 N/A. （DirectWrite 與轉譯無關，因此不知道色彩。應用程式需要自行追蹤。
GetTextExtentExPoint 取得字串中將符合空格的字元數。 IDWriteTextLayout：：GetMetrics
GetTextExtentExPointI 取得符合空格的字元索引數目。 IDWriteTextLayout：：GetMetrics
GetTextExtentPoint32 計算文字字串的寬度和高度。 IDWriteTextLayout：：GetMetrics
GetTextExtentPointI 計算圖像索引數位的寬度和高度。 IDWriteTextLayout：：GetMetrics
GetTextFace 取得選取至裝置內容之字型的名稱。 IDWriteFont：：GetFaceNames （傳回所有名稱）
GetTextMetrics 使用字型的度量填入緩衝區。 IDWriteFontFace：：GetMetrics
PolyTextOut 使用裝置內容中的字型和文字色彩繪製數個字串。 N/A;建立數個版面配置物件
RemoveFontMemResourceEx 從系統字型表格中移除來源內嵌在檔中的字型。 相關聯物件的 IUnknown：：Release
RemoveFontResource 從系統字型表格中移除檔案中的字型 N/A
RemoveFontResourceEx 從系統字型表格中移除私人或不可列舉的字型。 N/A
SetMapperFlags 改變用來將邏輯字型對應至實體字型的演算法。 N/A
SetTextAlign 設定裝置內容的文字對齊旗標。 IDWriteTextFormat：：SetTextAlignment
SetTextCharacterExtra 設定字元間間距。 N/A
SetTextColor 設定裝置內容的文字色彩。 應用程式必須負責指定其中一個 Draw 呼叫中的色彩。
SetTextJustification 指定系統應新增至字串中中斷字元的空間量。 N/A. 此版本不支援對齊和字元間距。
TabbedTextOut 在位置寫入字元字串，將索引標籤展開至指定的值。 IDWriteTextLayout：:D raw
TextOut 在位置寫入字元字串 IDWriteTextLayout：:D raw

 

 

 

  • Last updated on