CDC::GetTabbedTextExtent

Wywołać funkcję Członkowskie obliczyć szerokość i wysokość ciąg znaków za pomocą m_hAttribDC, atrybutu kontekstu urządzenia.

CSize GetTabbedTextExtent( 
   LPCTSTR lpszString, 
   int nCount, 
   int nTabPositions, 
   LPINT lpnTabStopPositions  
) const; 
CSize GetTabbedTextExtent( 
   const CString& str, 
   int nTabPositions, 
   LPINT lpnTabStopPositions  
) const;

Parametry

  • lpszString
    Wskazuje ciąg znaków.Można również przekazać CString obiektu dla tego parametru.

  • nCount
    Określa liczbę znaków w ciągu.Jeśli nCount jest –1, długość jest obliczana.

  • nTabPositions
    Określa liczbę pozycji tabulatora w tablicy wskazywanej przez lpnTabStopPositions.

  • lpnTabStopPositions
    Punkty do tablicy liczb całkowitych, zawierające pozycje tabulatora w jednostkach logicznych.Tabulatory musi być posortowana rosnąco; najmniejsza wartość x należy pierwszego elementu w tablicy.Tabulatory wsteczne nie są dozwolone.

  • str
    A CString obiektu zawierającego wyciągnąć określonych znaków.

Wartość zwracana

Wymiary ciąg (w jednostkach logicznych) w CSize obiektu.

Uwagi

Jeśli ciąg zawiera jeden lub więcej znaków tabulacji, szerokość ciągu opiera się na tabulatory określonej przez lpnTabStopPositions.Funkcja używa obecnie wybranej czcionki do wyliczenia wymiary ciąg.

Bieżący region przycinania nie przesunięcie szerokość i wysokość zwróconych przez GetTabbedTextExtent funkcji.

Ponieważ niektóre urządzenia należy umieszczać znaków w komórce regularne tablice (czyli one kerning znaków), suma zakresy znaków w ciągu może nie być w równym stopniu ciąg.

Jeśli nTabPositions 0 i lpnTabStopPositions jest NULL, tabulatory są rozwinięte do osiem razy średniej szerokości.Jeśli nTabPositions 1, tabulatorów będą rozdzielane podana przez pierwsza wartość w tablicy, do którego odległość lpnTabStopPositions punktów.Jeśli lpnTabStopPositions punkty do więcej niż jedną wartość tabulatora jest ustawiony dla każdej wartości w tablicy do liczby określonej przez nTabPositions.

Wymagania

Nagłówek: afxwin.h

Zobacz też

Informacje

Klasa CDC

Diagram hierarchii

CDC::GetTextExtent

CDC::GetOutputTabbedTextExtent

CDC::GetOutputTextExtent

CDC::TabbedTextOut

GetTabbedTextExtent

Klasa CSize