Elementos gráficos::D rawImage(Image*,constPointF*,INT,REAL,REAL,REAL,REAL,Unit,constImageAttributes*,DrawImageAbort,VOID*) (gdiplusgraphics.h)
O método Graphics::D rawImage desenha uma imagem.
Sintaxe
Status DrawImage(
[in] Image *image,
[in] const PointF *destPoints,
[in] INT count,
[in] REAL srcx,
[in] REAL srcy,
[in] REAL srcwidth,
[in] REAL srcheight,
[in] Unit srcUnit,
[in] const ImageAttributes *imageAttributes,
[in] DrawImageAbort callback,
[in] VOID *callbackData
);
Parâmetros
[in] image
Tipo: Imagem*
Ponteiro para um objeto Image que especifica a imagem de origem.
[in] destPoints
Tipo: const PointF*
Ponteiro para uma matriz de objetos PointF que especificam a área, em um parallelogram, na qual desenhar a imagem.
[in] count
Tipo: INT
Inteiro que especifica o número de elementos na matriz destPoints .
[in] srcx
Tipo: REAL
Número real que especifica a coordenada x do canto superior esquerdo da parte da imagem de origem a ser desenhada.
[in] srcy
Tipo: REAL
Número real que especifica a coordenada y do canto superior esquerdo da parte da imagem de origem a ser desenhada.
[in] srcwidth
Tipo: REAL
Número real que especifica a largura da parte da imagem de origem a ser desenhada.
[in] srcheight
Tipo: REAL
Número real que especifica a altura da parte da imagem de origem a ser desenhada.
[in] srcUnit
Tipo: Unidade
Elemento da enumeração Unit que especifica a unidade de medida para a imagem. O valor padrão é UnitPixel.
[in] imageAttributes
Tipo: ImageAttributes*
Ponteiro para um objeto ImageAttributes que especifica os atributos de cor e tamanho da imagem a ser desenhada. O valor padrão é NULL.
[in] callback
Tipo: DrawImageAbort
Método de retorno de chamada usado para cancelar o desenho em andamento. O valor padrão é NULL.
[in] callbackData
Tipo: VOID*
Ponteiro para dados adicionais usados pelo método especificado pelo parâmetro de retorno de chamada . O valor padrão é NULL.
Retornar valor
Tipo: Status
Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .
Se o método falhar, ele retornará um dos outros elementos da enumeração Status .
Comentários
O valor do parâmetro count deve ser igual a 3 para especificar as coordenadas do canto superior esquerdo, canto superior direito e canto inferior esquerdo do parallelogram. A coordenada do canto inferior direito é calculada usando as três coordenadas fornecidas, a largura e a altura da imagem. A parte da imagem de origem a ser desenhada é dimensionada para se ajustar ao parallelogram.
Exemplos
O exemplo a seguir desenha a imagem de origem original e desenha uma parte da imagem em um parallelogram especificado.
VOID Example_DrawImage4(HDC hdc)
{
Graphics graphics(hdc);
// Create an Image object.
Image image(L"pattern.png");
// Draw the original source image.
graphics.DrawImage(&image, 10, 10);
// Define the portion of the image to draw.
REAL srcX = 70.0f;
REAL srcY = 20.0f;
REAL srcWidth = 100.0f;
REAL srcHeight = 100.0f;
// Create an array of Point objects that specify the destination of the cropped image.
PointF destPoints[3] = {
PointF(230.0f, 30.0f),
PointF(350.0f, 50.0f),
PointF(275.0f, 120.0f)};
Point* pdestPoints = destPoints;
// Create an ImageAttributes object that specifies a recoloring from red to blue.
ImageAttributes remapAttributes;
ColorMap redToBlue;
redToBlue.oldColor = Color(255, 255, 0, 0);
redToBlue.newColor = Color(255, 0, 0, 255);
remapAttributes.SetRemapTable(1, &redToBlue);
// Draw the cropped image.
graphics.DrawImage(
&image,
pdestPoints,
3,
srcX,
srcY,
srcWidth,
srcHeight,
UnitPixel,
&remapAttributes,
NULL,
NULL);
}
A ilustração a seguir mostra a saída do código anterior.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | gdiplusgraphics.h (inclua Gdiplus.h) |
Biblioteca | Gdiplus.lib |
DLL | Gdiplus.dll |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de