Freigeben über


CDC::SetTextJustification

Fügt den Unterstreichung Leerzeichen in einer Zeichenfolge hinzu.

int SetTextJustification(
   int nBreakExtra,
   int nBreakCount 
);

Parameter

  • nBreakExtra
    Gibt den gesamten auf der Textzeile hinzugefügt werden zusätzlichen Abstand, (in logischen Einheiten).Wenn der aktuelle Zuordnungsmodus nicht MM_TEXT ist, wird der Wert, der von diesen Parameter angegeben wird, das aktuelle Zuordnungsmodus konvertiert und gerundet zur nächsten Geräteeinheit.

  • nBreakCount
    Gibt die Anzahl der Unterstreichung in der Zeile auf.

Rückgabewert

Ein wenn die Funktion erfolgreich; 0 andernfalls.

Hinweise

Eine Anwendung kann die GetTextMetrics-Memberfunktionen verwenden, um einer Unterstreichung Schriftarten abzurufen.

Nachdem die SetTextJustification-Memberfunktion aufgerufen wurde, verteilt ein Aufruf einer Textausgabefunktion (z TextOut) den angegebenen zusätzlichen Abstand gleichmäßig mit der angegebenen Anzahl von Unterstreichung.Die Unterstreichung ist normalerweise das Leerzeichen (ASCII) 32, jedoch wird von einer Schriftart als andere Zeichen definiert werden.

Die Memberfunktion GetTextExtent wird normalerweise mit SetTextJustification verwendet.GetTextExtent berechnet die Breite einer bestimmten Zeile vor Ausrichtung.Eine Anwendung kann bestimmen, wie viel im nBreakExtra-Parameter zu angeben, Leerzeichen, indem das Subtrahieren des Werts zurückgegeben hat, durch GetTextExtent aus der Breite der Zeichenfolge nach Ausrichtung.

Die SetTextJustification-Funktion kann verwendet werden, um eine Zeile ausrichten, die mehrere Testläufe in verschiedenen Schriftarten enthält.In diesem Fall muss die Zeile stückweise erstellt werden, indem jedes ausrichtet und schreibt, der separat ausgeführt wird.

Da Rundungsfehler während der Ausrichtung auftreten können, übergibt das System einen laufenden Fehlerbegriff, der den aktuellen Fehler definiert.Wenn eine Zeile an, die mehrere Testläufe enthält, verwendet GetTextExtent automatisch auch Fehlerbegriff, wenn es den Umfang der nächsten Ausführung abgeleitet.Dadurch kann die Textausgabefunktion, um den Fehler in die neue Ausführung zu mischen.

Nachdem jede Zeile ausgerichtet wurde, muss dieser Fehlerbegriff gelöscht werden, um sie an integriert werden in die nächste Zeile zu verhindern.Der Begriff kann durch das Aufrufen von SetTextJustification mit nBreakExtra gelöscht werden, das auf 0 festgelegt ist.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchien-Diagramm

CDC::GetMapMode

CDC::GetTextExtent

CDC::GetTextMetrics

CDC::SetMapMode

CDC::TextOut

SetTextJustification