Udostępnij za pośrednictwem


Formatuj wartości

Ta sekcja zawiera listę wartości używanych z parametrem dwTextFlags funkcji DrawThemeText i GetThemeTextEx tent. Co najmniej jedna z tych wartości służy do określania sposobu formatowania ciągu tekstowego. Funkcja DrawThemeText narysuje ciąg tekstowy wewnątrz prostokąta wyświetlania określonego przez parametr pRect. Funkcja GetThemeTextExtent może służyć do określenia niezbędnego prostokąta ograniczenia dla tekstu o danej długości i formacie.

Formatuj wartości

W poniższej tabeli wymieniono wartości formatu.

Wartość Opis
DT_BOTTOM Renderuje ciąg tekstowy w dolnej części prostokąta wyświetlania. Ta wartość jest używana tylko z wartością DT_SINGLELINE.
DT_CALCRECT Określa szerokość i wysokość prostokąta wyświetlania.
DT_CENTER Wyśrodkuje tekst w poziomie w prostokątze wyświetlania.
DT_EDITCONTROL Duplikuje charakterystykę wyświetlania tekstu kontrolki edycji wielowierszowej. W szczególności średnia szerokość znaku jest obliczana w taki sam sposób jak dla kontrolki edycji, a funkcja nie wyświetla częściowo widocznego ostatniego wiersza.
DT_END_ELLIPSIS Obcina ciąg tekstowy szerszy niż prostokąt wyświetlania i dodaje wielokropek, aby wskazać obcięcie. Ciąg nie jest modyfikowany, chyba że określono flagę DT_MODIFYSTRING.
DT_EXPANDTABS Rozwija znaki tabulacji. Domyślna liczba znaków na kartę to osiem. Wartości DT_WORD_ELLIPSIS, DT_PATH_ELLIPSIS i DT_END_ELLIPSIS nie mogą być używane z wartością DT_EXPANDTABS.
DT_EXTERNALLEADING Zawiera zewnętrzne wiodące czcionki w wysokości wiersza. Zwykle zewnętrzne wiodące nie są uwzględniane w wysokości wiersza tekstu.
DT_HIDEPREFIX Ignoruje znak prefiksu & w tekście. Następująca litera nie jest podkreślona, ale inne znaki prefiksu są nadal przetwarzane. Na przykład:
ciąg wejściowy: "A&bc&&d"
normalny: "Abc&d"
DT_HIDEPREFIX: "Abc&d"
DT_LEFT Wyrównuje tekst do lewej strony.
DT_MODIFYSTRING Modyfikuje ciąg, aby był zgodny z wyświetlanym tekstem. Ta wartość nie ma wpływu, chyba że określono DT_END_ELLIPSIS lub DT_PATH_ELLIPSIS.
DT_NOCLIP Rysuje ciąg tekstowy bez przycinania prostokąta wyświetlania.
DT_NOFULLWIDTHCHARBREAK Zapobiega podziałowi wiersza w zestawie znaków dwubajtowych (DBCS), dzięki czemu reguła podziału wiersza jest równoważna zestawowi znaków jednobajtowych (SBCS). Może to służyć na przykład do tworzenia etykiet ikon napisanych w tekście koreańskim. Ta wartość nie ma wpływu, chyba że określono DT_WORDBREAK.
DT_NOPREFIX Wyłącza przetwarzanie znaków prefiksu. Zwykle DrawThemeText interpretuje znak prefiksu & jako dyrektywę, aby podkreślić następujący znak, a znaki prefiksu && jako dyrektywę drukowania pojedynczego &. Określając DT_NOPREFIX, to przetwarzanie jest wyłączone. Na przykład:
ciąg wejściowy: "A&bc&&d"
normalny: "Abc&d"
DT_NOPREFIX: "A&bc&&d"
DT_PATH_ELLIPSIS Zamienia znaki w środku tekstu na wielokropek, tak aby wynik mieścił się w prostokątze wyświetlania. Jeśli ciąg zawiera znaki ukośnika odwrotnego (\), DT_PATH_ELLIPSIS zachowuje jak najwięcej tekstu po ostatnim ukośniku odwrotnym. Ciąg nie jest modyfikowany, chyba że określono flagę DT_MODIFYSTRING.
DT_PREFIXONLY Rysuje tylko podkreślenia na pozycji znaku po znaku prefiksu &. Zwykle DrawThemeText interpretuje & jako dyrektywę, aby podkreślić znak, który następuje, a znaki prefiksu && jako dyrektywę drukowania pojedynczego &. Określając DT_PREFIXONLY, żadne znaki nie są rysowane, tylko podkreślenie. Białe spacje są umieszczane w miejscach, w których zwykle pojawiają się znaki. Na przykład:
ciąg wejściowy: "A&bc&&d"
normalny: "Abc&d
DT_PREFIXONLY: " "
DT_RIGHT Wyrównuje tekst do prawej strony.
DT_RTLREADING Określa tekst w kolejności od prawej do lewej dla tekstu dwukierunkowego, na przykład tekstu w czcionki hebrajskiej lub arabskiej. Domyślny kierunek tekstu to od lewej do prawej.
DT_SINGLELINE Wyświetla tekst w jednym wierszu. Powroty karetki i przewody nie przerywają linii.
DT_TABSTOP Ustawia tabulatory.
DT_TOP Renderuje tekst w górnej części prostokąta wyświetlania.
DT_VCENTER Wyśrodkuje tekst w pionie. Ta wartość jest używana tylko z wartością DT_SINGLELINE.
DT_WORDBREAK Podziały wierszy między wyrazami, jeśli wyraz rozszerzałby krawędź prostokąta wyświetlania. Sekwencja powrotu karetki/linii (CR/LF) również przerywa linię.
DT_WORD_ELLIPSIS Obcina wszystkie wyrazy, które nie mieszczą się w prostokątze wyświetlania i dodaje wielokropek.