CDC::TabbedTextOut
Llame a esta función miembro para escribir una cadena de caracteres en la ubicación especificada, pestañas que expanda con los valores especificados en la matriz de posiciones de la interrupción de tabulación.
virtual CSize TabbedTextOut(
int x,
int y,
LPCTSTR lpszString,
int nCount,
int nTabPositions,
LPINT lpnTabStopPositions,
int nTabOrigin
);
CSize TabbedTextOut(
int x,
int y,
const CString& str,
int nTabPositions,
LPINT lpnTabStopPositions,
int nTabOrigin
);
Parámetros
x
Especifica la x- coordenada lógica el punto inicial de la cadena.y
Especifica la y- coordenada lógica el punto inicial de la cadena.lpszString
Apunta a la cadena de caracteres al dibujo.Puede pasar un puntero a una matriz de caracteres o un objeto de CString para este parámetro.nCount
Especifica el número de caracteres de la cadena.si es nCount – se calcula 1, la longitud.nTabPositions
Especifica el número de valores de la matriz de posiciones de la interrupción de tabulación.lpnTabStopPositions
Señala una matriz que contiene las posiciones de la interrupción de tabulación (en unidades lógicas).Las tabulaciones deben ordenar en sentido orden; el x-valor menor debe ser el primer elemento de la matriz.nTabOrigin
Especifica la x- coordenada de la posición inicial de la que se expanden las pestañas (en unidades lógicas).str
un objeto de CString que contiene los caracteres especificados.
Valor devuelto
Las dimensiones de la cadena (en unidades lógicas) como objeto de CSize .
Comentarios
El texto se escribe en la fuente seleccionada actualmente.Si nTabPositions es 0 y lpnTabStopPositions es NULL, fichas se expanden a ocho veces el ancho de caracteres medio.
Si nTabPositions es 1, las tabulaciones están separadas por la distancia especificada por el primer valor en la matriz de lpnTabStopPositions .Si la matriz de lpnTabStopPositions contiene más de un valor, una tabulación se establece para cada valor en la matriz, hasta el número especificado por nTabPositions.El parámetro de nTabOrigin permite que una aplicación para llamar a la función de TabbedTextOut varias veces para una sola línea.Si la aplicación llama a la función más de una vez con nTabOrigin establecido en el mismo valor cada vez, la función expanda todas las pestañas en relación con la posición especificada por nTabOrigin.
De forma predeterminada, la posición actual no se utiliza o no está actualizado por la función.Si una aplicación necesita actualizar la posición actual cuando llama a la función, la aplicación puede llamar a la función miembro de SetTextAlign con nFlags establecido en TA_UPDATECP.Cuando se establece este marcador, Windows omite el x y los parámetros de y en las llamadas posteriores a TabbedTextOut, mediante la posición actual en su lugar.
Requisitos
encabezado: afxwin.h