ScriptStringOut (Compact 2013)

3/28/2014

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

See Also

Reference

Uniscribe Functions
ScriptStringAnalyse
SCRIPT_STRING_ANALYSIS

Other Resources

RECT
SetTextAlign