ScriptStringOut (Windows Embedded CE 6.0)
1/6/2010
This function displays a string generated by a prior call to ScriptStringAnalyse and optionally adds highlighting.
Syntax
HRESULT WINAPI ScriptStringOut(
SCRIPT_STRING_ANALYSIS ssa,
int iX,
int iY,
UINT uOptions,
const RECT* prc,
int iMinSel,
int iMaxSel,
BOOL fDisabled
);
Parameters
- ssa
[in] A SCRIPT_STRING_ANALYSIS structure for the string.
- iX
[in] Specifies the x-coordinate of the reference point used to position the string.
- iY
[in] Specifies the y-coordinate of the reference point used to position the string.
uOptions
[in] Specifies how to use the application-defined rectangle. This parameter can be a combination of the following values.Value Description ETO_CLIPPED
The text will be clipped to the rectangle.
ETO_OPAQUE
The current background color should be used to fill the rectangle.
- prc
[in] Pointer to a RECT structure that defines a clipping rectangle. The puOptions parameter must be set to ETO_CLIPPED.
- iMinSel
[in] Starting position in the string. For no selection, set iMinSel >= iMaxSel.
- iMaxSel
[in] Ending position in the string.
fDisabled
[in] If this parameter is TRUE, the system applies disabled-text highlighting by setting the background color to COLOR_HIGHLIGHT behind all selected characters.If this parameter is FALSE, the system applies enabled-text highlighting by setting the background color to COLOR_HIGHLIGHT and the text color to COLOR_HIGHLIGHTTEXT for each selected character.
Return Value
If the function is successful, it returns S_OK.
If the function fails, it returns an HRESULT.
The return value can be tested with the SUCCEEDED and FAILED macros.
Remarks
This function requires that SSA_GLYPHS was requested in the original ScriptStringAnalyse call.
You should not use SetTextAlign with TA_UPDATECP when you are using ScriptStringOut because selected text will not be rendered correctly. If you must use this flag, you can unset and reset it as necessary to avoid the problem.
Requirements
| Header | usp10.h |
| Library | Uspce.lib |
| Windows Embedded CE | Windows CE 5.0 and later |
See Also
Reference
ScriptStringAnalyse
SCRIPT_STRING_ANALYSIS