Stiftfunktionen (GDI+)
Windows GDI+ macht eine flache API verfügbar, die aus etwa 600 Funktionen besteht, die in Gdiplus.dll implementiert und in Gdiplusflat.h deklariert werden. Die Funktionen in der GDI+ flachen API werden von einer Sammlung von etwa 40 C++-Klassen umschlossen. Es wird empfohlen, die Funktionen in der flachen API nicht direkt aufzurufen. Wenn Sie aufruft, GDI+, sollten Sie dazu die Methoden und Funktionen aufrufen, die von den C++-Wrappern bereitgestellt werden. Microsoft Product Support Services bietet keine Unterstützung für Code, der die flache API direkt aufruft. Weitere Informationen zur Verwendung dieser Wrappermethoden finden Sie unter GDI+ Flat-API.
Die folgenden flachen API-Funktionen werden von der Pen C++-Klasse umschlossen.
Stiftfunktionen und entsprechende Wrappermethoden
| Flat-Funktion | Wrappermethode | Bemerkungen |
|---|---|---|
| GpStatus WINGDIPAPI GdipCreatePen1(ARGB color, REAL width, GpUnit unit, GpPen * * pen) |
Pen::P en(IN const Color& color, IN REAL width = 1,0f) |
Erstellt ein Stiftobjekt, das eine angegebene Farbe und Breite verwendet. Der Unit-Parameter der flat-Funktion ist ein Member der Unit-Enumeration, der die Maßeinheit für die Breite des Stifts angibt. |
| GpStatus WINGDIPAPI GdipCreatePen2(GpBrush * brush, REAL width, GpUnit unit, GpPen * * pen) |
Pen::P en(IN const Brush * brush, IN REAL width = 1.0f) |
Erstellt ein Stiftobjekt, das die Attribute eines Pinsels und eine reelle Zahl verwendet, um die Breite dieses Stiftobjekts festzulegen. Der Unit-Parameter der flat-Funktion ist ein Member der Unit-Enumeration, der die Maßeinheit für die Breite des Stifts angibt. |
| GpStatus WINGDIPAPI GdipClonePen(GpPen * pen, GpPen * * clonepen) |
Pen * Pen::Clone() const |
Kopiert ein Stiftobjekt. |
| GpStatus WINGDIPAPI GdipDeletePen(GpPen-Stift) * |
Pen::~Pen() |
Gibt vom Pen-Objekt verwendete Ressourcen frei. |
| GpStatus WINGDIPAPI GdipSetPenWidth(GpPen * pen, REAL width) |
Status pen::SetWidth(IN REAL width) |
Legt die Breite für dieses Stiftobjekt fest. |
| GpStatus WINGDIPAPI GdipGetPenWidth(GpPen * pen, REAL * width) |
REAL Pen::GetWidth() const |
Ruft die derzeit für dieses Pen-Objekt festgelegte Breite ab. |
| GpStatus WINGDIPAPI GdipSetPenUnit(GpPen * pen, GpUnit unit) |
Wird nicht von Wrappermethoden aufgerufen. |
Diese Funktion legt die Maßeinheit für den durch den pen-Parameter angegebenen Stift auf den wert fest, der durch den Unitparameter angegeben wird. Der Unit-Parameter ist ein Member der Unit-Enumeration, der die Maßeinheit für die Breite des Stifts angibt. |
| GpStatus WINGDIPAPI GdipGetPenUnit(GpPen * pen, GpUnit * unit) |
Wird nicht von Wrappermethoden aufgerufen. |
Diese Funktion ruft die Maßeinheit für den Stift ab, der durch den pen-Parameter angegeben wird. Der Unit-Parameter empfängt einen Member der Unit-Enumeration, der die Maßeinheit für die Breite des Stifts angibt. |
| GpStatus WINGDIPAPI GdipSetPenLineCap197819(GpPen * pen, GpLineCap startCap, GpLineCap endCap, GpDashCap dashCap) |
Status pen::SetLineCap(IN LineCap startCap, IN LineCap endCap, IN DashCap dashCap) |
Legt die Obergrenzenstile für Start, Ende und Bindestriche in einer Mit diesem Stift gezeichneten Linie fest. |
| GpStatus WINGDIPAPI GdipSetPenStartCap(GpPen * pen, GpLineCap startCap) |
Status pen::SetStartCap(IN LineCap startCap) |
Legt die Startobergrenze für dieses Stiftobjekt fest. |
| GpStatus WINGDIPAPI GdipSetPenEndCap(GpPen * pen, GpLineCap endCap) |
Status pen::SetEndCap(IN LineCap endCap) |
Legt das Endende für dieses Stiftobjekt fest. |
| GpStatus WINGDIPAPI GdipSetPenDashCap197819(GpPen * pen, GpDashCap dashCap) |
Status pen::SetDashCap(IN DashCap dashCap) |
Legt das Bindestrich-Cap-Format für dieses Stiftobjekt fest. |
| GpStatus WINGDIPAPI GdipGetPenStartCap(GpPen * pen, GpLineCap * startCap) |
LineCap Pen::GetStartCap()const |
Ruft die Startobergrenze ab, die derzeit für dieses Pen-Objekt festgelegt ist. |
| GpStatus WINGDIPAPI GdipGetPenEndCap(GpPen * pen, GpLineCap * endCap) |
LineCap Pen::GetEndCap()const |
Ruft die end cap ab, die derzeit für dieses Pen-Objekt festgelegt ist. |
| GpStatus WINGDIPAPI GdipGetPenDashCap197819(GpPen * pen, GpDashCap * dashCap) |
DashCap Pen::GetDashCap() const |
Ruft das derzeit für dieses Pen-Objekt festgelegte Bindestrich-Cap-Format ab. |
| GpStatus WINGDIPAPI GdipSetPenLineJoin(GpPen * pen, GpLineJoin lineJoin) |
Status pen::SetLineJoin(IN LineJoin lineJoin) |
Legt den Zeilenbeitritt für dieses Stiftobjekt fest. |
| GpStatus WINGDIPAPI GdipGetPenLineJoin(GpPen * pen, GpLineJoin * lineJoin) |
LineJoin Pen::GetLineJoin() const |
Ruft den Zeilenbeitritt für dieses Pen-Objekt ab. |
| GpStatus WINGDIPAPI GdipSetPenCustomStartCap(GpPen * pen, GpCustomLineCap * customCap) |
Status Pen::SetCustomStartCap(IN const CustomLineCap * customCap) |
Legt die benutzerdefinierte Startobergrenze für dieses Stiftobjekt fest. |
| GpStatus WINGDIPAPI GdipGetPenCustomStartCap(GpPen * pen, GpCustomLineCap * * customCap) |
Pen::GetCustomStartCap(OUT CustomLineCap * customCap) const |
Ruft die benutzerdefinierte Startobergrenze für dieses Stiftobjekt ab. |
| GpStatus WINGDIPAPI GdipSetPenCustomEndCap(GpPen * pen, GpCustomLineCap * customCap) |
Status pen::SetCustomEndCap(IN const CustomLineCap * customCap) |
Legt die benutzerdefinierte Endobergrenze fest, die derzeit für dieses Stiftobjekt festgelegt ist. |
| GpStatus WINGDIPAPI GdipGetPenCustomEndCap(GpPen * pen, GpCustomLineCap * * customCap) |
Status pen::GetCustomEndCap(OUT CustomLineCap * customCap) const |
Ruft die benutzerdefinierte Endobergrenze ab, die derzeit für dieses Pen-Objekt festgelegt ist. |
| GpStatus WINGDIPAPI GdipSetPenMiterLimit(GpPen * pen, REAL miterLimit) |
Status pen::SetMiterLimit(IN REAL miterLimit) |
Legt die derzeit für dieses Pen-Objekt festgelegte Miterlänge fest. |
| GpStatus WINGDIPAPI GdipGetPenMiterLimit(GpPen * pen, REAL * miterLimit) |
REAL Pen::GetMiterLimit() const |
Ruft die derzeit für dieses Pen-Objekt festgelegte Miterlänge ab. |
| GpStatus WINGDIPAPI GdipSetPenMode(GpPen * pen, GpPenAlignment penMode) |
Status pen::SetAlignment(IN PenAlignment penAlignment) |
Legt die ausrichtung fest, die derzeit für dieses Stiftobjekt festgelegt ist. |
| GpStatus WINGDIPAPI GdipGetPenMode(GpPen * pen, GpPenAlignment * penMode) |
PenAlignment Pen::GetAlignment() const |
Legt die ausrichtung fest, die derzeit für dieses Stiftobjekt festgelegt ist. |
| GpStatus WINGDIPAPI GdipSetPenTransform(GpPen-Stift, * * GpMatrix-Matrix) |
Status pen::SetTransform(IN const Matrix * matrix) |
Legt die weltumwandlungsmatrix fest, die derzeit für dieses Pen-Objekt festgelegt ist. |
| GpStatus WINGDIPAPI GdipGetPenTransform(GpPen-Stift, * * GpMatrix-Matrix) |
Pen::GetTransform(OUT Matrix * matrix) const |
Ruft die derzeit für dieses Pen-Objekt festgelegte Welttransformationsmatrix ab. |
| GpStatus WINGDIPAPI GdipResetPenTransform(GpPen-Stift) * |
Status Pen::ResetTransform() |
Legt die Welttransformationsmatrix dieses Stiftobjekts auf die Identitätsmatrix fest. |
| GpStatus WINGDIPAPI GdipMultiplyPenTransform(GpPen * pen, GDIPCONST GpMatrix * matrix, GpMatrixOrder order) |
Status Pen::MultiplyTransform(IN const Matrix * matrix, IN MatrixOrder order = MatrixOrderPrepend) |
Aktualisiert die Welttransformationsmatrix dieses Stiftobjekts mit dem Produkt von sich selbst und einer anderen Matrix. |
| GpStatus WINGDIPAPI GdipTranslatePenTransform(GpPen * pen, REAL dx, REAL dy, GpMatrixOrder order) |
Wird nicht von Wrappermethoden aufgerufen. |
|
| GpStatus WINGDIPAPI GdipScalePenTransform(GpPen * pen, REAL sx, REAL sy, GpMatrixOrder order) |
Status Pen::ScaleTransform(IN REAL sx, IN REAL sy, IN MatrixOrder order = MatrixOrderPrepend) |
Legt die Welttransformationsmatrix des Stiftobjekts auf das Produkt selbst und eine Skalierungsmatrix fest. |
| GpStatus WINGDIPAPI GdipRotatePenTransform(GpPen * pen, REAL angle, GpMatrixOrder order) |
Status Pen::RotateTransform(IN REAL angle, IN MatrixOrder order = MatrixOrderPrepend) |
Aktualisiert die Welttransformationsmatrix dieses Stiftobjekts mit dem Produkt selbst und einer Drehungsmatrix. |
| GpStatus WINGDIPAPI GdipSetPenColor(GpPen * pen, ARGB argb) |
Status pen::SetColor(IN const Color& color) |
Legt die Farbe für dieses Stiftobjekt fest. |
| GpStatus WINGDIPAPI GdipGetPenColor(GpPen * pen, ARGB * argb) |
Status pen::GetColor(OUT Color * color) const |
Ruft die Farbe für dieses Pen-Objekt ab. |
| GpStatus WINGDIPAPI GdipSetPenBrushFill(GpPen * pen, GpBrush * brush) |
Status pen::SetBrush(IN const Brush * brush) |
Legt das Brush-Objekt fest, das ein Stift zum Füllen einer Linie verwendet. |
| GpStatus WINGDIPAPI GdipGetPenBrushFill(GpPen * pen, GpBrush * * brush) |
*Pinselstift::GetBrush() const |
Ruft das Brush-Objekt ab, das ein Stift zum Füllen einer Linie verwendet. |
| GpStatus WINGDIPAPI GdipGetPenFillType(GpPen * pen, GpPenType * type) |
PenType Pen::GetPenType() const |
Ruft den typ ab, der derzeit für dieses Pen-Objekt festgelegt ist. |
| GpStatus WINGDIPAPI GdipGetPenDashStyle(GpPen * pen, GpDashStyle * dashstyle) |
DashStyle Pen::GetDashStyle() const |
Ruft den derzeit für dieses Pen-Objekt festgelegten Bindestrichstil ab. |
| GpStatus WINGDIPAPI GdipSetPenDashStyle(GpPen * pen, GpDashStyle dashstyle) |
Status Pen::SetDashStyle(IN DashStyle dashStyle) |
Legt den derzeit für dieses Pen-Objekt festgelegten Bindestrichstil fest. |
| GpStatus WINGDIPAPI GdipGetPenDashOffset(GpPen * pen, REAL * offset) |
REAL Pen::GetDashOffset() const |
Ruft den Abstand vom Anfang der Zeile bis zum Anfang des ersten Leerzeichens in einer gestrichelten Linie ab. |
| GpStatus WINGDIPAPI GdipSetPenDashOffset(GpPen * pen, REAL offset) |
Status Pen::SetDashOffset(IN REAL dashOffset) |
Legt den Abstand vom Anfang der Zeile bis zum Anfang des ersten Leerzeichens in einer gestrichelten Linie fest. |
| GpStatus WINGDIPAPI GdipGetPenDashCount(GpPen * pen, INT * count) |
INT Pen::GetDashPatternCount() const |
Ruft die Anzahl der Elemente in einem Bindestrichmusterarray ab. |
| GpStatus WINGDIPAPI GdipSetPenDashArray(GpPen-Stift, * GDIPCONST * REAL-Bindestrich, INT-Anzahl) |
Status pen::SetDashPattern(IN const REAL * dashArray, IN INT count) |
Legt ein Array von benutzerdefinierten Bindestrichen und Leerzeichen fest, die derzeit für dieses Stiftobjekt festgelegt sind. |
| GpStatus WINGDIPAPI GdipGetPenDashArray(GpPen * pen, REAL * dash, INT count) |
Status pen::GetDashPattern(OUT REAL * dashArray, IN INT count) const |
Ruft ein Array benutzerdefinierter Bindestriche und Leerzeichen ab, die derzeit für dieses Pen-Objekt festgelegt sind. |
| GpStatus WINGDIPAPI GdipGetPenCompoundCount(GpPen * pen, INT * count) |
INT Pen::GetCompoundArrayCount() const |
Ruft die Anzahl der Elemente in einem zusammengesetzten Array ab. |
| GpStatus WINGDIPAPI GdipSetPenCompoundArray(GpPen-Stift, * GDIPCONST * REAL-Bindestrich, INT-Anzahl) |
Status Pen::SetCompoundArray(IN const REAL * compoundArray, IN INT count) |
Legt das zusammengesetzte Array fest, das derzeit für dieses Pen-Objekt festgelegt ist. |
| GpStatus WINGDIPAPI GdipGetPenCompoundArray(GpPen * pen, REAL * dash, INT count) |
Status Pen::GetCompoundArray(OUT REAL * compoundArray, IN INT count) const |
Ruft das zusammengesetzte Array ab, das derzeit für dieses Pen-Objekt festgelegt ist. |