CDC::GetCharacterPlacement

Articolo
06/10/2015

Recupera vari tipi di informazioni in una stringa di caratteri.

DWORD GetCharacterPlacement(
   LPCTSTR lpString,
   int nCount,
   int nMaxExtent,
   LPGCP_RESULTS lpResults,
   DWORD dwFlags
) const;
DWORD GetCharacterPlacement(
   CString& str,
   int nMaxExtent,
   LPGCP_RESULTS lpResults,
   DWORD dwFlags
) const;

Parametri

lpString
Puntatore alla stringa di caratteri da elaborare.
nCount
Specifica la lunghezza della stringa. Per la versione ANSI, è un numero di byte e per la funzione Unicode è un numero di PAROLE. Per ulteriori informazioni, vedere GetCharacterPlacement.
nMaxExtent
Specifica l'estensione massima (in unità logiche) a cui la stringa viene elaborata. I caratteri che, se elaborati, supererebbero questo ambito, vengono ignorati. I calcoli per tutte le matrici di glifi o di ordinamento si applicano solo ai caratteri inclusi. Questo parametro viene utilizzato solo se il valore GCP_MAXEXTENT viene specificato nel parametro dwFlags. Poiché la funzione elabora la stringa di input, ogni carattere e la relativa estensione vengono aggiunti alla matrice di output, di estensione e ad altre matrici solo se l'estensione totale non ha ancora superato il massimo. Una volta raggiunto il limite, l'elaborazione verrà arrestata.
lpResults
Puntatore a una struttura GCP_Results che riceve i risultati della funzione.
dwFlags
Specifica come elaborare la stringa nelle matrici necessarie. Questo parametro può essere uno o più dei valori riportati nella sezione dwFlags dell'argomento GetCharacterPlacement.
str
Un puntatore a un oggetto CString da elaborare.