CDC::GetCharacterPlacement
Recupera distintos tipos de información en una cadena de caracteres.
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;
Parámetros
lpString
Puntero a la cadena de caracteres que se va a procesar.nCount
Especifica la longitud de la cadena. Para la versión ANSI, es un recuento de bytes y para la función Unicode es un recuento de palabras. Para obtener más información, vea GetCharacterPlacement.nMaxExtent
Especifica la extensión máxima (en unidades lógicas) en la que se procesa la cadena. Se omiten los caracteres que, si se procesaran, superarían esta extensión. Los cálculos para cualquier matriz de glifos u ordenación necesaria se aplican solo a los caracteres incluidos. Este parámetro solo se usa si el valor de GCP_MAXEXTENT se especifica en el parámetro dwFlags. Cuando la función procesa la cadena de entrada, cada carácter y su extensión se agregan a la salida, a la extensión y a otras matrices solo si la extensión total no ha superado todavía el máximo. Una vez alcanzado el límite, el procesamiento se detendrá.lpResults
Puntero a una estructura GCP_Results que recibe los resultados de la función.dwFlags
Especifica cómo procesar la cadena en las matrices necesarias. Este parámetro puede tener uno o más de los valores enumerados en la sección dwFlags del tema GetCharacterPlacement.str
Un puntero a un objeto CString que se va a procesar.
Valor devuelto
Si la función tiene éxito, el valor devuelto es el ancho y alto de la cadena en unidades lógicas.
Si la función no se realiza correctamente, el valor devuelto es cero.
Comentarios
Esta función miembro emula la funcionalidad de la función GetCharacterPlacement, como se describe en Windows SDK.
Requisitos
Encabezado: afxwin.h