Region::GetData, méthode (gdiplusheaders.h)

La méthode Region::GetData obtient des données qui décrivent cette région.

Syntaxe

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

Paramètres

[out] buffer

Type : BYTE*

Pointeur vers un tableau de valeurs BYTE qui reçoit les données de région.

[in] bufferSize

Type : UINT

Entier qui spécifie la taille, en octets, du tableau de mémoires tampons . La taille du tableau de mémoires tampons peut être supérieure ou égale au nombre d’octets requis pour stocker les données de région. Le nombre exact d’octets requis peut être déterminé en appelant la méthode Region::GetDataSize .

[out] sizeFilled

Type : UINT*

Optionnel. Pointeur vers un INT qui reçoit le nombre d’octets de données réellement reçus par le tableau de mémoires tampons . La valeur par défaut est NULL.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Notes

La méthode Region::GetDataSize peut être utilisée avant la méthode Region::GetData pour déterminer le nombre d’octets nécessaires pour stocker les données de région. Ensuite, vous pouvez allouer une mémoire tampon qui est de la taille appropriée pour stocker les données de région et définir le paramètre de mémoire tampon pour qu’il pointe vers la mémoire tampon.

Exemples

L’exemple suivant crée une région à partir d’un chemin d’accès, puis obtient les données qui décrivent la région.

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;
}

Spécifications