SetTextCharacterExtra 函式 (wingdi.h)

SetTextCharacterExtra 函式會設定字元間距。當系統寫入一行文字時，會將字元間距新增至每個字元，包括斷字元。

語法

int SetTextCharacterExtra(
  [in] HDC hdc,
  [in] int extra
);

[in] hdc

裝置內容的句柄。

[in] extra

要新增至每個字元的額外空間數量，以邏輯單元為單位。如果目前的對應模式未MM_TEXT， 則會轉換 nCharExtra 參數，並四捨五入為最接近的圖元。

如果函式成功，則傳回值是先前的字元間距。

如果函式失敗，傳回值會0x80000000。

此函式主要支援與現有應用程式的相容性。新的應用程式通常應該避免呼叫此函式，因為它與需要文字成形的複雜腳本不相容 (腳本;阿拉伯文腳本是這個) 的範例。

建議的方法是，應用程式應該呼叫 ExtTextOut 並使用其 lpDx 參數來提供寬度，而不是呼叫此函式，然後呼叫 TextOut。