CDC::TabbedTextOut
Rufen Sie die Memberfunktion auf, um eine Zeichenfolge an der angegebenen Position zu schreiben und Registerkarten auf Werte erweitern, die im Array von Tabulationspositionen angegeben werden.
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
);
Parameter
x
Gibt die logische x-Koordinate des Anfangspunkts der Zeichenfolge.y
Gibt die logische y-Koordinate des Anfangspunkts der Zeichenfolge.lpszString
Punkte zur Zeichenfolge zum Sie umbrochenen.Sie können entweder einen Zeiger auf ein Array Zeichen oder ein CString-Objekt für diesen Parameter übergeben.nCount
Gibt die Anzahl der Zeichen in der Zeichenfolge.Wenn nCount ist -1, die Länge wird berechnet.nTabPositions
Gibt die Anzahl der Werte im Array von Tabulationspositionen an.lpnTabStopPositions
Punkte in einem Array, das die Tabulationspositionen enthält (in logischen Einheiten).Die Tabstopps müssen in aufsteigender Reihenfolge sortiert werden, der kleinste XWert sollte der erste Punkt im Array sein.nTabOrigin
Gibt die X-Koordinate der Startposition an, von der Registerkarten erweitert werden (in logischen Einheiten).str
Ein CString-Objekt, das die angegebenen Zeichen enthält.
Rückgabewert
Die Dimensionen der Zeichenfolge (in logischen Einheiten) als CSize-Objekt.
Hinweise
Text wird in die aktuell ausgewählte Schriftart geschrieben.Wenn nTabPositions 0 ist und lpnTabStopPositionsNULL ist, werden Registerkarten zu achtmal die durchschnittliche Zeichenbreite erweitert.
Wenn nTabPositions 1 ist, werden die Tabstopps durch den Abstand getrennt, der durch den ersten Wert im lpnTabStopPositions Array angegeben wird.Wenn das lpnTabStopPositions Array mehr als einen Wert enthält, wird ein Tabstopp für jeden Wert im Array, bis der Zahl festgelegt, die von nTabPositions angegeben wird.Der nTabOrigin-Parameter ermöglicht es einer Anwendung, die TabbedTextOut-Funktion mehrmals für eine einzelne Zeile aufzurufen.Wenn die Anwendung die - Funktion mehrmals mit nTabOrigin aufruft, das jedes Mal auf den gleichen Wert festgelegt wird, erweitert die Funktion alle Registerkarten relativ zur Position, die von nTabOrigin angegeben wird.
Standardmäßig wird die aktuelle Position nicht von der Funktion verwendet oder aktualisiert.Wenn eine Anwendung die aktuelle Position aktualisieren muss, wenn die Funktion aufruft, kann die Anwendung die SetTextAlign-Memberfunktion mit nFlags aufrufen, das zu TA_UPDATECP festgelegt ist.Wenn dieses Flag festgelegt ist, ignoriert Windows die x- und y-Parameter bei nachfolgenden Aufrufen von TabbedTextOut und verwendet stattdessen die aktuelle Position.
Anforderungen
Header: afxwin.h