Share via


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
    Un puntero a la cadena de caracteres a procesar.

  • nCount
    Especifica la longitud de la cadena.Para la versión ANSI, es un recuento de byte y para la función Unicode es un recuento de WORD .Para obtener más información, vea GetCharacterPlacement.

  • nMaxExtent
    Especifica la extensión máxima (en unidades lógicas) al que se procesa la cadena.Se omiten los caracteres que, si se procesan, superarían esta extensión.Los cálculos para cualquier matriz necesaria la clasificación o de glifo solo se aplican a los caracteres incluidos.Se utiliza este parámetro sólo si el valor de GCP_MAXEXTENT se especifica en el parámetro de dwFlags .Como la función procesa la cadena de entrada, cada carácter y la extensión se agrega a la salida, la extensión, y otras matrices sólo si la extensión total todavía no ha superado el máximo.El límite se alcanza una vez, procesando se detendrá.

  • lpResults
    Puntero a una estructura de GCP_RESULTS que recibe los resultados de la función.

  • dwFlags
    Especifica cómo procesar la cadena en matrices necesarias.Este parámetro puede tener uno o varios de los valores mostrados en la sección de dwFlags de tema de GetCharacterPlacement .

  • str
    Un puntero a un objeto de CString al proceso.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es el ancho y el alto de la cadena en unidades lógicas.

Si se produce un error en la función, 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

Vea también

Referencia

Clase de la CDC

Gráfico de jerarquía

CDC::ExtTextOut

CDC::GetCharABCWidths

CDC::GetTextMetrics