Region::GetData 메서드(gdiplusheaders.h)

Region::GetData 메서드는 이 지역을 설명하는 데이터를 가져옵니다.

구문

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

매개 변수

[out] buffer

형식: BYTE*

지역 데이터를 수신하는 BYTE 값 배열에 대한 포인터입니다.

[in] bufferSize

형식: UINT

버퍼 배열의 크기(바이트)를 지정하는 정수입니다. 버퍼 배열의 크기는 지역 데이터를 저장하는 데 필요한 바이트 수보다 크거나 같을 수 있습니다. 필요한 정확한 바이트 수는 Region::GetDataSize 메서드를 호출하여 확인할 수 있습니다.

[out] sizeFilled

형식: UINT*

(선택 사항) 버퍼 배열에서 실제로 받은 데이터의 바이트 수를 수신하는 INT에 대한 포인터입니다. 기본값은 NULL입니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 확인을 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

설명

Region::GetDataSize 메서드를 Region::GetData 메서드 앞에 사용하여 지역 데이터를 저장하는 데 필요한 바이트 수를 확인할 수 있습니다. 그런 다음 올바른 크기의 버퍼를 할당하여 지역 데이터를 저장하고 버퍼 매개 변수를 버퍼 를 가리키도록 설정할 수 있습니다.

예제

다음 예제에서는 경로에서 영역을 만든 다음 지역을 설명하는 데이터를 가져옵니다.

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

요구 사항

지원되는 최소 클라이언트	Windows XP, Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	gdiplusheaders.h(Gdiplus.h 포함)
라이브러리	Gdiplus.lib
DLL	Gdiplus.dll