GetTextCharsetInfo 函式 (wingdi.h)

擷取目前選取到指定裝置內容之字型的字元集相關信息。

語法

int GetTextCharsetInfo(
  [in]            HDC             hdc,
  [out, optional] LPFONTSIGNATURE lpSig,
  [in]            DWORD           dwFlags
);

參數

[in] hdc

裝置內容的控制代碼。 函式會取得在此裝置內容中選取字型的相關信息。

[out, optional] lpSig

接收字型簽章資訊的 FONTSIGNATURE 數據結構的指標。

如果目前已選取 TrueType 字型到裝置內容中, FONTSIGNATURE 結構會接收資訊,以識別字型所提供的代碼頁和 Unicode 子範圍。

如果 TrueType 以外的字型目前已選取到裝置內容中, FONTSIGNATURE 結構就會收到零。 在此情況下,應用程式應該使用 TranslateCharsetInfo 函式來取得字元集的一般字型簽章資訊。

如果應用程式不需要 FONTSIGNATURE 資訊,lpSig 參數會指定 NULL。 在此情況下,應用程式也可以呼叫 GetTextCharset 函式,這相當於呼叫 GetTextCharsetInfo,並將 lpSig 設定為 NULL

[in] dwFlags

保留;必須設定為 0。

傳回值

如果成功,會傳回值,識別目前選取到指定裝置內容的字型字元集。 定義下列字元集識別碼:

如果函式失敗,傳回值會DEFAULT_CHARSET。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

FONTSIGNATURE

GetTextCharset

TranslateCharsetInfo

Unicode 和字元集函式

Unicode 和字元集