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 Zeichenfolge zu verarbeiten.

  • nCount
    Gibt die Länge der Zeichenfolge an.Für die ANSI-Version ist es eine BYTE Anzahl und für die Unicode-Funktion ist es eine WORD Anzahl.Weitere Informationen finden Sie unter GetCharacterPlacement.

  • nMaxExtent
    Gibt den maximalen Grad an (in logischen Einheiten) zu dem die Zeichenfolge verarbeitet wird.Zeichen, die, wenn sie verarbeitet werden, diesen Wertebereich überschreiten würden, werden ignoriert.Berechnungen für alle erforderlichen Reihenfolge oder Symbolarrays gelten nur für die enthaltenen Zeichen in.Dieser Parameter wird nur verwendet, wenn der GCP_MAXEXTENT-Wert im dwFlags-Parameter angegeben wird.Da die Funktion die Eingabezeichenfolge verarbeitet, wird jedes Zeichen und sein Wertebereich zur Ausgabe, um Wertebereich und andere Arrays nur hinzugefügt, wenn der gesamte Wertebereich noch nicht das Maximum überschritten hat.Sobald das Limit erreicht und verarbeitet wird.

  • lpResults
    Zeiger auf eine GCP_RESULTS-Struktur, die die Ergebnisse der Funktion erhält.

  • dwFlags
    Gibt an, wie die Zeichenfolge in die erforderlichen Arrays verarbeitet.Dieser Parameter kann einen oder mehrere der Werte sein, die im dwFlags-Abschnitt des GetCharacterPlacement Themas aufgelistet werden.

  • str
    Ein Zeiger auf ein zu verarbeitendes CString-Objekt.

Rückgabewert

Wenn die Funktion folgt, ist der Rückgabewert auf die Breite und Höhe der Zeichenfolge in logischen Einheiten.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null.

Hinweise

Diese Memberfunktion emuliert die Funktionen der Funktion GetCharacterPlacement, wie in Windows SDK beschrieben.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchien-Diagramm

CDC::ExtTextOut

CDC::GetCharABCWidths

CDC::GetTextMetrics