CDC::GetTextExtentExPointI

Ruft die Anzahl der Zeichen in einer angegebenen Zeichenfolge, die innerhalb eines angegebenen Bereichs passt ab und füllt ein Array mit dem Textwertebereich für jedes dieser Zeichen aus.

BOOL GetTextExtentExPointI(
   LPWORD pgiIn,
   int cgi,
   int nMaxExtent,
   LPINT lpnFit,
   LPINT alpDx,
   LPSIZE lpSize
) const;

Parameter

  • pgiIn
    Ein Zeiger auf ein Array Symbolindizes, für die Wertebereiche abgerufen werden sollen.

  • cgi
    Gibt die Anzahl von Symbolen im Array, das auf durch pgiIn gezeigt wird.

  • nMaxExtent
    Gibt die maximal zulässige Breite, in logischen Einheiten, der formatierten Zeichenfolge.

  • lpnFit
    Ein Zeiger auf eine ganze Zahl, die eine Anzahl der maximalen Anzahl der Zeichen empfängt, die im Bereich passen, wurden durch nMaxExtent an.Wenn lpnFitNULL ist, wird nMaxExtent ignoriert.

  • alpDx
    Ein Zeiger auf ein Array von ganzen Zahlen, das partielle Symbolwertebereiche empfängt.Jedes Element im Array gibt den Abstand, in logischen Einheiten, zwischen dem Beginn des Symbolindexarrays und einem der Symbole, die der in das Leerzeichen dieser sind, das von nMaxExtent angegeben wird.Obwohl dieses Array so viele Elemente als Symbolindizes mindestens soll, die von cgi angegeben werden, füllt die Funktion das Array mit Wertebereichen nur für bis zu Symbolindizes aus, durch lpnFit angegeben werden.Wenn lpnDxNULL ist, berechnet die Funktion nicht Teilzeichenfolgenbreiten.

  • lpSize
    Zeiger auf eine GRÖSSE-Struktur, die die Dimensionen des Symbolindexarrays empfängt, in logischen Einheiten.Dieser Wert kann nicht NULL sein.

Rückgabewert

Ungleich 0 (null), wenn die Funktion erfolgreich; 0 andernfalls.

Hinweise

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

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchien-Diagramm

CDC::GetTextExtentPointI