Fungsi GetRegionData (wingdi.h)
Fungsi GetRegionData mengisi buffer yang ditentukan dengan data yang menjelaskan wilayah. Data ini mencakup dimensi persegi panjang yang membentuk wilayah tersebut.
Sintaks
DWORD GetRegionData(
[in] HRGN hrgn,
[in] DWORD nCount,
[out] LPRGNDATA lpRgnData
);
Parameter
[in] hrgn
Handel ke wilayah tersebut.
[in] nCount
Ukuran, dalam byte, dari buffer lpRgnData .
[out] lpRgnData
Penunjuk ke struktur RGNDATA yang menerima informasi. Dimensi wilayah berada dalam unit logis. Jika parameter ini ADALAH NULL, maka nilai yang dikembalikan berisi jumlah byte yang diperlukan untuk data wilayah.
Nilai kembali
Jika fungsi berhasil dan nCount menentukan jumlah byte yang memadai, maka nilai yang dikembalikan sama dengan jumlah byte aktual yang digunakan (kurang dari atau sama dengan nCount).
Jika lpRgnData adalah NULL, maka nilai yang dikembalikan adalah jumlah byte yang diperlukan.
Jika fungsi gagal, maka nilai yang dikembalikan adalah nol.
Jika kegagalan disebabkan oleh hrgn yang tidak valid, maka GetLastError mengembalikan ERROR_INVALID_HANDLE. Jika tidak, GetLastError mengembalikan ERROR_INVALID_PARAMETER .
Jika nCount terlalu kecil, maka fungsi gagal.
Keterangan
Fungsi GetRegionData digunakan bersama dengan fungsi ExtCreateRegion .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | wingdi.h (sertakan Windows.h) |
| Pustaka | Gdi32.lib |
| DLL | Gdi32.dll |