CDC::GetCharacterPlacement
Récupère différents types d'informations sur une chaîne de caractères.
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;
Paramètres
lpString
Pointeur vers la chaîne de caractères à traiter.nCount
Spécifie la longueur de la chaîne. Pour la version ANSI, il s'agit d'un nombre BYTE et pour la fonction Unicode, il s'agit d'un nombre WORD. Pour plus d'informations, consultez GetCharacterPlacement.nMaxExtent
Spécifie l'étendue maximale (en unités logiques) sur laquelle la chaîne est traitée. Les caractères qui, s'ils sont traités, dépasseraient cette étendue sont ignorés. Les calculs pour tous les tableaux de glyphe ou d'ordonnancement requis s'appliquent uniquement aux caractères inclus. Ce paramètre est utilisé uniquement si la valeur GCP_MAXEXTENT est spécifiée dans le paramètre dwFlags. Pendant le traitement de la chaîne d'entrée par la fonction, chaque caractère et son étendue sont ajoutés à la sortie, étendue et autres tableaux uniquement si tous l'étendue totale n'a pas encore dépassé le maximum. Une fois la limite atteinte, le traitement s'arrête.lpResults
Pointeur vers une structure GCP_Results qui reçoit les résultats de la fonction.dwFlags
Spécifie comment traiter la chaîne dans les tableaux requis. Ce paramètre peut prendre une ou plusieurs des valeurs répertoriées dans la section dwFlags de la rubrique GetCharacterPlacement.str
Pointeur vers un objet CString à traiter.
Valeur de retour
Si la fonction réussit, la valeur de retour est la largeur et la hauteur de la chaîne en unités logiques.
Si la fonction échoue, la valeur de retour est zéro.
Notes
Cette fonction membre émule la fonctionnalité de la fonction GetCharacterPlacement, comme décrit dans Kit de développement logiciel Windows.
Configuration requise
En-tête : afxwin.h