ScriptStringOut-Funktion (usp10.h)

Artikel
03/06/2024

Zeigt eine Zeichenfolge an, die von einem vorherigen Aufruf von ScriptStringAnalyse generiert wurde, und fügt optional Hervorhebungen hinzu.

Syntax

HRESULT ScriptStringOut(
  [in]           SCRIPT_STRING_ANALYSIS ssa,
  [in]           int                    iX,
  [in]           int                    iY,
  [in]           UINT                   uOptions,
  [in, optional] const RECT             *prc,
  [in]           int                    iMinSel,
  [in]           int                    iMaxSel,
  [in]           BOOL                   fDisabled
);

Parameter

[in] ssa

Eine SCRIPT_STRING_ANALYSIS-Struktur für die Zeichenfolge.

[in] iX

Die x-Koordinate des Bezugspunkts, der zum Positionieren der Zeichenfolge verwendet wird.

[in] iY

Die y-Koordinate des Bezugspunkts, der zum Positionieren der Zeichenfolge verwendet wird.

[in] uOptions

Optionen, die die Verwendung des anwendungsdefinierten Rechtecks angeben. Dieser Parameter kann auf 0 oder auf einen der folgenden Werte festgelegt werden. Die Werte können mit binärem OR kombiniert werden.

Wert	Bedeutung
ETO_CLIPPED	Schneiden Sie Text an das Rechteck ab.
ETO_OPAQUE	Verwenden Sie die aktuelle Hintergrundfarbe, um das Rechteck zu füllen.

[in, optional] prc

Zeiger auf eine RECT-Struktur , die das zu verwendende Rechteck definiert. Wenn uOptions auf ETO_OPAQUE und NULL für prc angegeben wird, ist die Funktion erfolgreich und gibt S_OK zurück. Wenn die Anwendung jedoch uOptions auf ETO_CLIPPING festlegt und NULL für prc bereitstellt, gibt die Funktion E_INVALIDARG zurück. Die Anwendung kann diesen Parameter auf NULL festlegen, um anzugeben, dass keine Option erforderlich ist.

[in] iMinSel

Nullbasierter Index, der die Startposition in der Zeichenfolge angibt. Ohne Auswahl sollte die Anwendung iMinSel>= iMaxSel festlegen.

[in] iMaxSel

Nullbasierter Index, der die Endposition in der Zeichenfolge angibt.

[in] fDisabled

TRUE , wenn das Betriebssystem deaktivierte Textherhebungen anwendet, indem die Hintergrundfarbe auf COLOR_HIGHLIGHT hinter allen markierten Zeichen festgelegt wird. Die Anwendung kann diesen Parameter auf FALSE festlegen, wenn das Betriebssystem die Hervorhebung aktivierter Text anwendet, indem die Hintergrundfarbe auf COLOR_HIGHLIGHT und die Textfarbe auf COLOR_HIGHLIGHTTEXT für jedes ausgewählte Zeichen festgelegt wird.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Die Funktion gibt einen HRESULT-Wert ungleich null zurück, wenn sie nicht erfolgreich ist. Die Anwendung kann den Rückgabewert nicht mit den Makros SUCCEEDED und FAILED testen.

Hinweise

Um diese Funktion verwenden zu können, muss die Anwendung SSA_GLYPHS in ihrem ursprünglichen Aufruf von ScriptStringAnalyse angeben.

Die Anwendung sollte SetTextAlign nicht mit TA_UPDATECP verwenden, wenn ScriptStringOut verwendet wird, da ausgewählter Text nicht ordnungsgemäß gerendert werden kann. Wenn die Anwendung dieses Flag verwenden muss, kann sie das Flag nach Bedarf aufheben und zurücksetzen, um das Problem zu vermeiden.

Wichtig Ab Windows 8: Um die Ausführung unter Windows 7 zu gewährleisten, muss ein Modul, das Uniscribe verwendet, Usp10.lib vor gdi32.lib in der Bibliotheksliste angeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	usp10.h
Bibliothek	Usp10.lib
DLL	Usp10.dll

Weitere Informationen

SCRIPT_STRING_ANALYSIS

ScriptStringAnalyse

Uniscribe

Uniscribe-Funktionen

Share via