Método Region::GetData (gdiplusheaders.h)

O método Region::GetData obtém dados que descrevem essa região.

Sintaxe

Status GetData(
  [out] BYTE *buffer,
  [in]  UINT bufferSize,
  [out] UINT *sizeFilled
);

Parâmetros

[out] buffer

Tipo: BYTE*

Ponteiro para uma matriz de valores BYTE que recebe os dados da região.

[in] bufferSize

Tipo: UINT

Inteiro que especifica o tamanho, em bytes, da matriz de buffer . O tamanho da matriz de buffers pode ser maior ou igual ao número de bytes necessários para armazenar os dados da região. O número exato de bytes necessários pode ser determinado chamando o método Region::GetDataSize .

[out] sizeFilled

Tipo: UINT*

Opcional. Ponteiro para um INT que recebe o número de bytes de dados realmente recebidos pela matriz de buffers . O valor padrão é NULL.

Valor retornado

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 método Region::GetDataSize pode ser usado antes do método Region::GetData para determinar o número de bytes necessários para armazenar os dados da região. Em seguida, você pode alocar um buffer que é o tamanho correto para armazenar os dados da região e definir o parâmetro buffer para apontar para o buffer.

Exemplos

O exemplo a seguir cria uma região de um caminho e obtém os dados que descrevem a região.

VOID Example_GetData(HDC)

{
   Point points[] = {
      Point(110, 20)
      Point(120, 30),
      Point(100, 60),
      Point(120, 70),
      Point(150, 60),
      Point(140, 10)};
   GraphicsPath path;
   path.AddClosedCurve(points, 6);
   
   // Create a region from a path.
   Region pathRegion(&path); 
      
   // Get the region data.
   UINT bufferSize = 0;
   UINT sizeFilled = 0;
   BYTE* pData = NULL;
   
   bufferSize = pathRegion.GetDataSize();
   
   pData = new BYTE[bufferSize];
   pathRegion.GetData(pData, bufferSize, &sizeFilled);
   
   // Inspect or use the region data.
   ...
   delete pData;
}

Requisitos

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	gdiplusheaders.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll