CDC::SetTextJustification

Artykuł
02/27/2013

Dodaje odstęp znaki podziału w ciągu.

int SetTextJustification(
   int nBreakExtra,
   int nBreakCount 
);

Parametry

nBreakExtra
Określa całkowity dodatkowe miejsce do dodania do wiersza tekstu (w jednostkach logicznych).Jeśli bieżący tryb mapowania nie jest MM_TEXT, wartości tego parametru jest konwertowane na bieżący tryb mapowania i zaokrąglana do najbliższej jednostki urządzenia.
nBreakCount
Określa liczbę znaków podziału wiersza.

Wartość zwracana

Jeden, jeśli funkcja jest pomyślne; 0 inaczej.

Uwagi

Można użyć aplikacji GetTextMetrics funkcji elementów członkowskich, aby pobrać czcionki break znaków.

Po SetTextJustification Członkowskich wywoływana jest funkcja, wywołanie funkcji tekst wyjściowy (takich jak TextOut) rozpowszechnia określonego dodatkowe miejsce równomiernie między określoną liczbę znaków podziału.Znak podziału jest zwykle znak spacji (ASCII 32), ale mogą być określone przez czcionkę jako niektórych innych znaków.

Funkcja Członkowskie GetTextExtent jest zazwyczaj używane z SetTextJustification.GetTextExtentoblicza szerokość danej linii przed wyrównania.Aplikacja może określić ilość miejsca, aby określić w nBreakExtra parametr odejmując wartość zwracana przez GetTextExtent z szerokość ciąg po wyrównanie.

SetTextJustification Funkcja umożliwia wyrównywanie wiersz, który zawiera wiele działa w różnych czcionek.W tym przypadku wiersz musi rozproszone utworzony przez wyrównywanie i pisania każdego uruchomienia oddzielnie.

Ponieważ błędy zaokrągleń mogą wystąpić podczas wyrównywania, system przechowuje uruchomione termin błędu, która definiuje błąd bieżącego.Podczas wyrównywania wiersz, który zawiera wiele serii, GetTextExtent automatycznie używa termin ten błąd, gdy oblicza zakres następnym uruchomieniu.Umożliwia to funkcja tekst wyjściowy do uruchomienia nowych błędu.

Po każdym wierszu zostały dostosowane, termin ten błąd musi być wyczyszczone, aby zapobiec jest włączona do następnego wiersza.Termin może wyczyszczone, wywołując SetTextJustification z nBreakExtra ustawiona na 0.