|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| gdi32.lib
| Header File
| wingdi.h
| Unicode
| No
| Platform Notes
| None
|
|
|
GetDIBColorTable
The GetDIBColorTable function retrieves RGB (red, green, blue) color values from a range of entries
in the color table of the DIB section bitmap that is currently selected into a
specified device context.
UINT GetDIBColorTable(
HDC hdc,
| // handle of device context whose DIB is of interest
| UINT uStartIndex,
| // color table index of first entry to retrieve
| UINT cEntries,
| // number of color table entries to retrieve
| RGBQUAD *pColors
| // pointer to buffer that receives color table entries
| );
|
|
Parameters
hdc
Specifies a device context. A DIB section bitmap must be selected into this
device context.
uStartIndex
A zero-based color table index that specifies the first color table entry to
retrieve.
cEntries
Specifies the number of color table entries to retrieve.
pColors
Points to a buffer that receives an array of RGBQUAD data structures containing color information from the DIB's color table. The
buffer must be large enough to contain as many RGBQUAD data structures as the value of cEntries.
Return Values
If the function succeeds, the return value is the number of color table
entries that the function retrieves.
If the function fails, the return value is zero. To get extended error
information, call GetLastError.
Remarks
The GetDIBColorTable function should be called to retrieve the color table for DIB section bitmaps
that use 1, 4, or 8 bits per pixel. The biBitCount member of a bitmap's associated BITMAPINFOHEADER structure specifies the number of bits per pixel. DIB section bitmaps with a biBitCount value greater than 8 do not have a color table, but they do have associated
color masks. Call the GetObject function to retrieve those color masks.
See Also
BITMAPINFOHEADER, CreateDIBSection, DIBSECTION, GetObject, RGBQUAD, SetDIBColorTable
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
