SetTextCharacterExtra.md

Home

Function name : SetTextCharacterExtra

Group: Font and Text - Library: gdi32

---

The SetTextCharacterExtra function sets the intercharacter spacing. Intercharacter spacing is added to each character, including break characters, when the system writes a line of text.

---

Code examples:

Using Font and Text functions

Declaration:

int SetTextCharacterExtra(
  HDC hdc,         // handle to DC
  int nCharExtra   // extra-space value
);  

---

FoxPro declaration:

DECLARE INTEGER SetTextCharacterExtra IN gdi32;
	INTEGER hdc,;
	INTEGER nCharExtra  

---

Parameters:

hdc [in] Handle to the device context.

nCharExtra [in] Specifies the amount of extra space, in logical units, to be added to each character.

---

Return value:

If the function succeeds, the return value is the previous intercharacter spacing. If the function fails, the return value is 0x80000000.

---