IDWriteTextAnalysisSource::GetTextAtPosition-Methode (dwrite.h)
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 |