CDC::GetCharacterPlacement
Ruft verschiedene Typen von Informationen zu einer Zeichenfolge ab.
DWORD GetCharacterPlacement(
LPCTSTR lpString,
int nCount,
int nMaxExtent,
LPGCP_RESULTS lpResults,
DWORD dwFlags
) const;
DWORD GetCharacterPlacement(
CString& str,
int nMaxExtent,
LPGCP_RESULTS lpResults,
DWORD dwFlags
) const;
Parameter
lpString
Ein Zeiger auf die zu verarbeitende Zeichenfolge.nCount
Gibt die Länge der Zeichenfolge an. Bei der ANSI-Version ist es eine Byteanzahl und bei der Unicode-Funktion ist es eine Wortanzahl. Weitere Informationen finden Sie unter GetCharacterPlacement.nMaxExtent
Gibt der maximale Wertbereich (in logischen Einheiten) an, zu dem die Zeichenfolge verarbeitet wird. Zeichen, die diesen Wertbereich bei Verarbeitung überschreiten würden, werden ignoriert. Berechnungen für alle erforderlichen Reihenfolge- oder Glyphenarrays gelten nur für die enthaltenen Zeichen. Dieser Parameter wird nur verwendet, wenn der GCP_MAXEXTENT-Wert im Parameter dwFlags angegeben wird. Da die Funktion die Eingabezeichenfolge verarbeitet, wird jedes Zeichen und sein Wertebereich nur dann der Ausgabe, dem Wertebereich und anderen Arrays hinzugefügt, wenn der gesamte Wertebereich das Maximum noch nicht überschritten hat. Bei Erreichen des Limits wird die Verarbeitung beendet.lpResults
Zeiger auf eine GCP_Results-Struktur mit den Ergebnissen der Funktion.dwFlags
Gibt das Verarbeiten der Zeichenfolge in die erforderlichen Arrays an. Dieser Parameter kann mindestens einer der Werte im dwFlags-Abschnitt des GetCharacterPlacement-Themas aufgeführten Werte sein.str
Ein Zeiger auf ein zu verarbeitendes CString-Objekt.
Rückgabewert
Wenn die Funktion erfolgreich ist, handelt es sich bei dem Rückgabewert um die Breite und Höhe der Zeichenfolge in logischen Einheiten.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Diese Memberfunktion emuliert die Funktionen der GetCharacterPlacement- Funktion, wie in Windows SDK beschrieben.
Anforderungen
Header: afxwin.h