Funções de penetração (GDI+)

O Windows GDI+ expõe uma API simples que consiste em cerca de 600 funções, que são implementadas em Gdiplus.dll e declaradas em Gdiplusflat.h. As funções na API plana GDI+ são encapsuladas por uma coleção de cerca de 40 classes C++. É recomendável que você não chame diretamente as funções na API simples. Sempre que você fizer chamadas para GDI+, deverá fazer isso chamando os métodos e as funções fornecidos pelos wrappers C++. Os Serviços de Suporte a Produtos da Microsoft não fornecerão suporte para o código que chama a API simples diretamente. Para obter mais informações sobre como usar esses métodos wrapper, consulte API Simples GDI+.

As seguintes funções de API simples são encapsuladas pela classe Pen C++.

Funções de caneta e métodos wrapper correspondentes

Função simples	Método Wrapper	Comentários
GpStatus WINGDIPAPI GdipCreatePen1(cor ARGB, largura REAL, unidade GpUnit, GpPen **caneta)	Pen::P en(IN const Color color& , IN REAL width = 1.0f)	Cria um objeto Pen que usa uma cor e largura especificadas. O parâmetro de unidade da função simples é um membro da enumeração Unit que especifica a unidade de medida para a largura da caneta.
GpStatus WINGDIPAPI GdipCreatePen2(GpBrush *brush, REAL width, GpUnit unit, GpPen **pen)	Pen::P en(IN const Brush* brush, IN REAL width = 1.0f)	Cria um objeto Pen que usa os atributos de um pincel e um número real para definir a largura desse objeto Pen . O parâmetro de unidade da função simples é um membro da enumeração Unit que especifica a unidade de medida para a largura da caneta.
GpStatus WINGDIPAPI GdipClonePen(GpPen *pen, GpPen **clonepen)	Caneta* Pen::Clone() const	Copia um objeto Pen.
GpStatus WINGDIPAPI GdipDeletePen(GpPen *pen)	Caneta::~Caneta()	Libera recursos usados pelo objeto Pen .
GpStatus WINGDIPAPI GdipSetPenWidth(GpPen *pen, REAL width)	Caneta de status::SetWidth(IN REAL width)	Define a largura deste objeto Pen .
GpStatus WINGDIPAPI GdipGetPenWidth(GpPen *pen, REAL *width)	Real Pen::GetWidth() const	Obtém a largura definida atualmente para este objeto Pen .
GpStatus WINGDIPAPI GdipSetPenUnit(GpPen *pen, unidade GpUnit)	Não chamado pelos métodos wrapper.	Essa função define a unidade de medida para a caneta especificada pelo parâmetro de caneta como o valor especificado pelo parâmetro unit . O parâmetro unit é um membro da enumeração Unit que especifica a unidade de medida para a largura da caneta.
GpStatus WINGDIPAPI GdipGetPenUnit(GpPen *pen, GpUnit *unit)	Não chamado pelos métodos wrapper.	Essa função obtém a unidade de medida para a caneta especificada pelo parâmetro de caneta . O parâmetro unit recebe um membro da enumeração Unit que indica a unidade de medida para a largura da caneta.
GpStatus WINGDIPAPI GdipSetPenLineCap197819(GpPen *pen, GpLineCap startCap, GpLineCap endCap, GpDashCap dashCap)	Caneta de status::SetLineCap(IN LineCap startCap, IN LineCap endCap, IN DashCap dashCap)	Define os estilos de tampa para o início, o fim e os traços em uma linha desenhada com esta caneta.
GpStatus WINGDIPAPI GdipSetPenStartCap(GpPen *pen, GpLineCap startCap)	Caneta de Status::SetStartCap(IN LineCap startCap)	Define o limite inicial para este objeto Pen .
GpStatus WINGDIPAPI GdipSetPenEndCap(GpPen *pen, GpLineCap endCap)	Caneta de Status::SetEndCap(IN LineCap endCap)	Define o limite final para este objeto Pen .
GpStatus WINGDIPAPI GdipSetPenDashCap197819(GpPen *pen, GpDashCap dashCap)	Caneta de status::SetDashCap(IN DashCap dashCap)	Define o estilo da tampa do traço para este objeto Pen .
GpStatus WINGDIPAPI GdipGetPenStartCap(GpPen *pen, GpLineCap *startCap)	Caneta LineCap::GetStartCap()const	Obtém o limite inicial definido atualmente para este objeto Pen .
GpStatus WINGDIPAPI GdipGetPenEndCap(GpPen *pen, GpLineCap *endCap)	Caneta LineCap::GetEndCap()const	Obtém o limite final atualmente definido para este objeto Pen .
GpStatus WINGDIPAPI GdipGetPenDashCap197819(GpPen *pen, GpDashCap *dashCap)	Caneta DashCap::GetDashCap() const	Obtém o estilo de limite de traço definido atualmente para este objeto Pen .
GpStatus WINGDIPAPI GdipSetPenLineJoin(GpPen *pen, GpLineJoin lineJoin)	Caneta de Status::SetLineJoin(IN LineJoin lineJoin)	Define a junção de linha para este objeto Pen .
GpStatus WINGDIPAPI GdipGetPenLineJoin(GpPen *pen, GpLineJoin *lineJoin)	LineJoin Pen::GetLineJoin() const	Obtém a junção de linha para este objeto Pen .
GpStatus WINGDIPAPI GdipSetPenCustomStartCap(GpPen *pen, GpCustomLineCap* customCap)	Caneta de status::SetCustomStartCap(IN const CustomLineCap* customCap)	Define o limite de início personalizado para este objeto Pen .
GpStatus WINGDIPAPI GdipGetPenCustomStartCap(GpPen *pen, GpCustomLineCap** customCap)	Pen::GetCustomStartCap(OUT CustomLineCap* customCap) const	Obtém o limite de início personalizado para este objeto Pen .
GpStatus WINGDIPAPI GdipSetPenCustomEndCap(GpPen *pen, GpCustomLineCap* customCap)	Caneta de status::SetCustomEndCap(IN const CustomLineCap* customCap)	Define o limite final personalizado definido atualmente para este objeto Pen
GpStatus WINGDIPAPI GdipGetPenCustomEndCap(GpPen *pen, GpCustomLineCap** customCap)	Caneta de status::GetCustomEndCap(OUT CustomLineCap* customCap) const	Obtém o limite final personalizado definido atualmente para este objeto Pen
GpStatus WINGDIPAPI GdipSetPenMiterLimit(GpPen *pen, REAL miterLimit)	Caneta de status::SetMiterLimit(IN REAL miterLimit)	Define o comprimento do miter definido atualmente para este objeto Pen .
GpStatus WINGDIPAPI GdipGetPenMiterLimit(GpPen *pen, REAL *miterLimit)	REAL Pen::GetMiterLimit() const	Obtém o comprimento do miter atualmente definido para este objeto Pen .
GpStatus WINGDIPAPI GdipSetPenMode(GpPen *pen, GpPenAlignment penMode)	Caneta de Status::SetAlignment(IN PenAlignment penAlignment)	Define o alinhamento definido atualmente para este objeto Pen .
GpStatus WINGDIPAPI GdipGetPenMode(GpPen *pen, GpPenAlignment *penMode)	PenAlignment Pen::GetAlignment() const	Define o alinhamento definido atualmente para este objeto Pen .
GpStatus WINGDIPAPI GdipSetPenTransform(GpPen *pen, GpMatrix *matrix)	Caneta de status::SetTransform(IN const Matrix* matrix* matrix)	Define a matriz de transformação do mundo atualmente definida para este objeto Pen .
GpStatus WINGDIPAPI GdipGetPenTransform(GpPen *pen, GpMatrix *matrix)	Pen::GetTransform(OUT Matrix* matrix) const	Obtém a matriz de transformação do mundo atualmente definida para este objeto Pen .
GpStatus WINGDIPAPI GdipResetPenTransform(GpPen *pen)	Caneta de Status::ResetTransform()	Define a matriz de transformação mundial desse objeto Pen como a matriz de identidade.
GpStatus WINGDIPAPI GdipMultiplyPenTransform(GpPen *pen, GDIPCONST GpMatrix *matrix, gpMatrixOrder order)	Status Pen::MultiplyTransform(IN const Matrix* matrix, IN MatrixOrder order = MatrixOrderPrepend)	Atualizações a matriz de transformação mundial desse objeto Pen com o produto de si mesmo e outra matriz.
GpStatus WINGDIPAPI GdipTranslatePenTransform(GpPen *pen, REAL dx, REAL dy, GpMatrixOrder order)	Caneta de status::TranslateTransform(GpPen *pen, Real dx, REAL dy, gpMatrixOrder order)	Atualizações a matriz de transformação mundial desse objeto Pen com o produto de si mesmo e outra matriz.
GpStatus WINGDIPAPI GdipScalePenTransform(GpPen *pen, REAL sx, REAL sy, GpMatrixOrder order)	Status Pen::ScaleTransform(IN REAL sx, IN REAL sy, IN MatrixOrder order = MatrixOrderPrepend)	Define a matriz de transformação do mundo do objeto Pen igual ao produto de si mesmo e a uma matriz de dimensionamento.
GpStatus WINGDIPAPI GdipRotatePenTransform(GpPen *pen, REAL angle, GpMatrixOrder order)	Caneta de status::RotateTransform(IN REAL angle, IN MatrixOrder order = MatrixOrderPrepend)	Atualizações a matriz de transformação mundial deste objeto Pen com o produto de si mesmo e uma matriz de rotação.
GpStatus WINGDIPAPI GdipSetPenColor(GpPen *pen, ARGB argb)	Caneta de status::SetColor(IN const Color color& )	Define a cor deste objeto Pen .
GpStatus WINGDIPAPI GdipGetPenColor(GpPen *pen, ARGB *argb)	Status Pen::GetColor(OUT Color* color) const	Obtém a cor deste objeto Pen .
GpStatus WINGDIPAPI GdipSetPenBrushFill(GpPen *pen, GpBrush *brush)	Caneta de status::SetBrush(IN const Brush* brush)	Define o objeto Brush que uma caneta usa para preencher uma linha.
GpStatus WINGDIPAPI GdipGetPenBrushFill(GpPen *pen, GpBrush **brush)	Brush* Pen::GetBrush() const	Obtém o objeto Brush que uma caneta usa para preencher uma linha.
GpStatus WINGDIPAPI GdipGetPenFillType(GpPen *pen, gpPenType* type)	PenType Pen::GetPenType() const	Obtém o tipo definido atualmente para este objeto Pen .
GpStatus WINGDIPAPI GdipGetPenDashStyle(GpPen *pen, GpDashStyle *dashstyle)	Caneta DashStyle::GetDashStyle() const	Obtém o estilo de traço definido atualmente para este objeto Pen .
GpStatus WINGDIPAPI GdipSetPenDashStyle(GpPen *pen, GpDashStyle dashstyle)	Caneta de status::SetDashStyle(IN DashStyle dashStyle)	Define o estilo de traço definido atualmente para este objeto Pen .
GpStatus WINGDIPAPI GdipGetPenDashOffset(GpPen *pen, REAL *offset)	Real Pen::GetDashOffset() const	Obtém a distância do início da linha até o início do primeiro espaço em uma linha tracejada.
GpStatus WINGDIPAPI GdipSetPenDashOffset(GpPen *pen, REAL offset)	Caneta de status::SetDashOffset(IN REAL dashOffset)	Define a distância do início da linha até o início do primeiro espaço em uma linha tracejada.
GpStatus WINGDIPAPI GdipGetPenDashCount(GpPen *pen, INT *count)	INT Pen::GetDashPatternCount() const	Obtém o número de elementos em uma matriz de padrões de traço.
GpStatus WINGDIPAPI GdipSetPenDashArray(GpPen *pen, GDIPCONST REAL *dash, INT count)	Caneta de status::SetDashPattern(IN const REAL* dashArray, IN INT count)	Define uma matriz de traços personalizados e espaços atualmente definidos para este objeto Pen .
GpStatus WINGDIPAPI GdipGetPenDashArray(GpPen *pen, REAL *dash, INT count)	Caneta de status::GetDashPattern(OUT REAL* dashArray, IN INT count) const	Obtém uma matriz de traços personalizados e espaços atualmente definidos para este objeto Pen .
GpStatus WINGDIPAPI GdipGetPenCompoundCount(GpPen *pen, INT *count)	INT Pen::GetCompoundArrayCount() const	Obtém o número de elementos em uma matriz composta.
GpStatus WINGDIPAPI GdipSetPenCompoundArray(GpPen *pen, GDIPCONST REAL *dash, INT count)	Caneta de status::SetCompoundArray(IN const REAL* compoundArray, IN INT count)	Define a matriz composta definida atualmente para este objeto Pen .
GpStatus WINGDIPAPI GdipGetPenCompoundArray(GpPen *pen, REAL *dash, INT count)	Caneta de status::GetCompoundArray(OUT REAL* compoundArray, IN INT count) const	Obtém a matriz composta atualmente definida para este objeto Pen .