Método StringFormat::SetTabStops (gdiplusstringformat.h)
El método StringFormat::SetTabStops establece los desplazamientos de las tabulaciones en este objeto StringFormat .
Sintaxis
Status SetTabStops(
[in] REAL firstTabOffset,
[in] INT count,
[in] const REAL *tabStops
);
Parámetros
[in] firstTabOffset
Tipo: REAL
Número real que especifica la posición de desplazamiento inicial. Esta posición de desplazamiento inicial es relativa al origen de la cadena y el desplazamiento de la primera tabulación es relativo a la posición de desplazamiento inicial.
[in] count
Tipo: INT
Entero que especifica el número de desplazamientos de tabulación en la matriz tabStops .
[in] tabStops
Tipo: const REAL*
Puntero a una matriz de números reales que especifican los desplazamientos de tabulación. El desplazamiento de la primera tabulación es el primer valor de la matriz, el desplazamiento de la segunda tabulación, el segundo valor de la matriz, etc.
Valor devuelto
Tipo: Estado
Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .
Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .
Comentarios
Cada desplazamiento de tabulación de la matriz tabStops , excepto el primero, es relativo al anterior. El primer desplazamiento de tabulación es relativo a la posición de desplazamiento inicial especificada por firstTabOffset. Por ejemplo, si la posición de desplazamiento inicial es 8 y el primer desplazamiento de tabulación es 50, la primera tabulación está en la posición 58. Si la posición de desplazamiento inicial es cero, el primer desplazamiento de tabulación es relativo a la posición 0, el origen de la cadena.
Ejemplos
En el ejemplo siguiente se crea un objeto StringFormat , se establecen las tabulaciones y se usa el objeto StringFormat para dibujar una cadena que contiene caracteres de tabulación (\t). El código también dibuja el rectángulo de diseño de la cadena.
VOID Example_SetTabStops(HDC hdc)
{
Graphics graphics(hdc);
REAL tabs[] = {150, 100, 100};
FontFamily fontFamily(L"Courier New");
Font font(&fontFamily, 12, FontStyleRegular, UnitPoint);
SolidBrush solidBrush(Color(255, 0, 0, 255));
StringFormat stringFormat;
stringFormat.SetTabStops(0, 3, tabs);
graphics.DrawString(
L"Name\tTest 1\tTest 2\tTest 3",
25,
&font,
RectF(20, 20, 500, 100),
&stringFormat,
&solidBrush);
// Draw the rectangle that encloses the text.
Pen pen(Color(255, 255, 0, 0));
graphics.DrawRectangle(&pen, 20, 20, 500, 100);
}
Requisitos
| Cliente mínimo compatible | Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | gdiplusstringformat.h (include Gdiplus.h) |
| Library | Gdiplus.lib |
| Archivo DLL | Gdiplus.dll |