Freigeben über


CDC::GetTextExtent

Rufen Sie die Memberfunktion auf, um die Breite und die Höhe einer Textzeile mit der aktuellen Schriftarten zu berechnen, um die Dimensionen zu bestimmen.

CSize GetTextExtent( 
   LPCTSTR lpszString, 
   int nCount  
) const; 
CSize GetTextExtent( 
   const CString& str  
) const;

Parameter

  • lpszString
    zeigt auf eine Zeichenfolge. Sie können ein CString-Objekt für diesen Parameter übergeben.

  • nCount
    Gibt die Anzahl der Zeichen in der Zeichenfolge.

  • str
    Ein CString-Objekt, das die angegebenen Zeichen enthält.

Rückgabewert

Die Dimensionen der Zeichenfolge (in logischen Einheiten) in einem CSize-Objekt.

Hinweise

Die Informationen werden von m_hAttribDC, der Attributgerätekontext abgerufen.

Standardmäßig akzeptiert GetTextExtent an, dass der Text, für den es abruft, die Dimension nach einem horizontalen Linie festgelegt ist (das heißt, ist der Vorschub 0). Wenn Sie eine Schriftart erstellen, die einen Vorschub ungleich 0 (null) angibt, müssen Sie den Winkel des Texts explizit konvertieren, um die Dimensionen der Zeichenfolge abzurufen.

Der aktuelle Clippingbereich wirkt sich nicht auf die Breite und Höhe, die von GetTextExtent zurückgegeben werden.

Da einige Geräte keine Zeichen in regulären Zellenträgern (das heißt, führen sie Kerning) durch, platzieren, könnte die Summe des Wertebereichs der Zeichen in einer Zeichenfolge nicht dem Umfang der Zeichenfolge.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchiediagramm

CDC::GetTabbedTextExtent

CDC::m_hAttribDC

CDC::m_hDC

CDC::GetOutputTextExtent

CDC::SetTextJustification

CSize Class