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

  • 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

Other Resources

Uniscribe Functions
RECT
SetTextAlign