Método Bitmap::Clone(constRect&,PixelFormat) (gdiplusheaders.h)

Artigo
02/29/2024

O método Bitmap::Clone cria um novo objeto Bitmap copiando uma parte desse bitmap.

Sintaxe

Bitmap * Clone(
  const Rect & rect,
  PixelFormat  format
);

Parâmetros

rect

Referência a um retângulo que especifica a parte deste bitmap a ser copiada.

format

Inteiro que especifica o formato de pixel do novo bitmap. O tipo de dados PixelFormat e as constantes que representam vários formatos de pixel são definidos em Gdipluspixelformats.h. Para obter mais informações sobre constantes de formato de pixel, consulte Constantes de formato de pixel de imagem.

Retornar valor

Tipo: Bitmap*

Esse método retorna um ponteiro para o novo objeto Bitmap.

Comentários

Exemplos

O exemplo a seguir cria um objeto Bitmap de um arquivo de imagem, clona a parte superior esquerda da imagem e desenha a imagem clonada.

VOID Example_Clone(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Bitmap object from a JPEG file.
   Bitmap bitmap(L"Climber.jpg");

   // Clone a portion of the bitmap.
   Bitmap* clone = bitmap.Clone(Rect(0, 0, 100, 100), PixelFormatDontCare);

   // Draw the clone.
   graphics.DrawImage(clone, 0, 0);

   delete clone;
}