Region::GetData-Methode (gdiplusheaders.h)

Die Region::GetData-Methode ruft Daten ab, die diese Region beschreiben.

Syntax

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

Parameter

[out] buffer

Typ: BYTE*

Zeiger auf ein Array von BYTE-Werten , das die Regionsdaten empfängt.

[in] bufferSize

Typ: UINT

Eine ganze Zahl, die die Größe des Pufferarrays in Byte angibt. Die Größe des Pufferarrays kann größer oder gleich der Anzahl von Bytes sein, die zum Speichern der Regionsdaten erforderlich sind. Die genaue Anzahl der erforderlichen Bytes kann durch Aufrufen der Region::GetDataSize-Methode bestimmt werden.

[out] sizeFilled

Typ: UINT*

Optional. Zeiger auf einen INT-Wert , der die Anzahl der Vom Pufferarray tatsächlich empfangenen Bytes an Daten empfängt. Der Standardwert ist NULL.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Die Region::GetDataSize-Methode kann vor der Region::GetData-Methode verwendet werden, um die Anzahl von Bytes zu bestimmen, die zum Speichern der Regionsdaten erforderlich sind. Anschließend können Sie einen Puffer mit der richtigen Größe zuweisen, um die Regionsdaten zu speichern, und den Pufferparameter so festlegen, dass er auf den Puffer verweist.

Beispiele

Im folgenden Beispiel wird eine Region aus einem Pfad erstellt und dann die Daten abgerufen, die die Region beschreiben.

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

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll