Freigeben über

IDWriteTextAnalysisSource::GetTextAtPosition-Methode (dwrite.h)

  • Artikel

Ruft einen Textblock ab, der an der angegebenen Textposition beginnt.

Syntax

HRESULT GetTextAtPosition(
        UINT32      textPosition,
  [out] WCHAR const **textString,
  [out] UINT32      *textLength
);

Parameter

textPosition

Typ: UINT32

Die erste Position des abzurufenden Stücks. Alle Positionen befinden sich in UTF16-Codeeinheiten , nicht in ganzen Zeichen, was wichtig ist, wenn ergänzende Zeichen verwendet werden.

[out] textString

Typ: const WCHAR**

Wenn diese Methode zurückgibt, enthält eine Adresse des Textblocks als Array von Zeichen, die aus der Textanalyse abgerufen werden sollen.

[out] textLength

Typ: UINT32*

Wenn diese Methode zurückgibt, enthält die Anzahl der UTF16-Einheiten des abgerufenen Blocks. Die zurückgegebene Länge ist nicht die Länge des Blocks, sondern die im Block verbleibende Länge von der angegebenen Position bis zu seinem Ende. Wenn Sie beispielsweise eine Position abfragen, die 75 Positionen in einem Block mit 100 Positionen beträgt, würde 25 zurückgegeben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die Rückgabe von NULL gibt das Ende des Texts an, d. h. die Position nach dem letzten Zeichen. Diese Funktion wird für jeden aufeinanderfolgenden Block iterativ aufgerufen und bindet mehrere fragmentierte Blöcke im Sicherungsspeicher zu einer virtuellen zusammenhängenden Zeichenfolge zusammen.

Anwendungen können zwar spärliche Textinhalte implementieren, die nur einen Teil des Sicherungsspeichers zuordnen, aber die Anwendung muss jeden Text zuordnen, der sich in dem Bereich befindet, der an beliebige Analysefunktionen übergeben wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile dwrite.h
Bibliothek Dwrite.lib
DLL Dwrite.dll

Weitere Informationen

IDWriteTextAnalysisSource