CDC::GetCharacterPlacement

Recupera i 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
    Un puntatore alla stringa di caratteri da elaborare.

  • nCount
    Specifica la lunghezza della stringa.Per la versione ANSI, è un conteggio BYTE e per la funzione Unicode è un conteggio parole.Per ulteriori informazioni, vedere GetCharacterPlacement.

  • nMaxExtent
    Specifica l'ambito massimo (in unità logiche) che la stringa viene elaborata.I caratteri che, se elaborati, supererebbero questo ambito vengono ignorati.I calcoli per tutte le matrici richieste di glifo l'ordinamento o si applicano solo ai caratteri contenuti.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 l'ambito viene aggiunto nell'output, nella misura e altre matrici solo se l'ambito totale non ha superato il massimo.Una volta che viene raggiunto il limite, elaborare verrà interrotta.

  • 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 argument GetCharacterPlacement.

  • str
    Un puntatore a un oggetto CString al processo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è la larghezza e l'altezza della stringa in unità logiche.

Se la funzione ha esito negativo, il valore restituito è zero.

Note

Questa funzione membro emula la funzionalità della funzione GetCharacterPlacement, come descritto in Windows SDK.

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

Classe CDC

Grafico della gerarchia

CDC::ExtTextOut

CDC::GetCharABCWidths

CDC::GetTextMetrics