Metodo IDWriteTextAnalysisSource::GetTextAtPosition (dwrite.h)

Ottiene un blocco di testo a partire dalla posizione di testo specificata.

Sintassi

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

Parametri

textPosition

Tipo: UINT32

Prima posizione del pezzo da ottenere. Tutte le posizioni si trovano in unità di codice UTF16 , non intere, che importa quando vengono usati caratteri supplementari.

[out] textString

Tipo: const WCHAR**

Quando questo metodo restituisce, contiene un indirizzo del blocco di testo come matrice di caratteri da recuperare dall'analisi del testo.

[out] textLength

Tipo: UINT32*

Quando questo metodo restituisce, contiene il numero di unità UTF16 del blocco recuperato. La lunghezza restituita non è la lunghezza del blocco, ma la lunghezza rimanente nel blocco, dalla posizione specificata fino alla sua fine. Ad esempio, la query per una posizione che corrisponde a 75 posizioni in un blocco di 100 posizioni restituirebbe 25.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

La restituzione di NULL indica la fine del testo, ovvero la posizione dopo l'ultimo carattere. Questa funzione viene chiamata iterativamente per ogni blocco consecutivo, legando insieme diversi blocchi frammentati nell'archivio di backup in una stringa contigua virtuale.

Anche se le applicazioni possono implementare contenuto testuale sparse che esegue il mapping solo parte dell'archivio di backup, l'applicazione deve eseguire il mapping di qualsiasi testo nell'intervallo passato a qualsiasi funzione di analisi.

Requisiti

Vedi anche

IDWriteTextAnalysisSource