函式功能
該函式檢索預定義的備用筆、刷子、字型或者調色板的句柄。
函式原型
HGDIOBJ GetStockObject(int fnObject);
參數
主要參數
fnObject:指定對象的類型,該參數可取如下值之一;
BLACK_BRUSH:黑色畫刷;DKGRAY_BRUSH:暗灰色畫刷;
DC_BRUSH:在Windows98,Windows NT 5.0和以後版本中為純顏色畫刷,預設色為白色,可以用SetDCBrushColor函式改變顏色,更多的信息參見以下的注釋部分。
GRAY_BRUSH:灰色畫刷筆;
HOLLOW_BRUSH:空畫刷(相當於NULL_BRUSH);
NULL_BRUSH:空畫刷(相當於HOLLOW_BRUSH);
LTGRAY_BRUSH:亮灰色畫刷;
WHITE_BRUSH:白色畫刷;
BLACK_PEN:黑色鋼筆;
DC_PEN:在Windows98、Windows NT 5.0和以後版本中為純色鋼筆,預設色為白色,使用SetDCPenColor函式可以改變色彩,更多的信息,參見下面的注釋部分。
WHITE_PEN:白色鋼筆;
ANSI_FIXED_FONT:在Windows中為固定間距(等寬)系統字型;
ANSI_VAR_FONT:在Windows中為變間距(比例間距)系統字型;
DEVICE_DEFAUCT_FONT:在WindowsNT中為設備相關字型;
DEFAULT_GUI_FONT:用戶界面對象預設字型,如選單和對話框;
OEM_FIXED_FONT:原始設備製造商(OEM)相關固定間距(等寬)字型;
SYSTEM_FONT:系統字型,在預設情況下,系統使用系統字型繪製選單,對話框控制和文本;
SYSTEM_FIXED_FONT:固定間距(等寬)系統字型,該對象僅提供給兼容16位Windows版本;
DEFAULT_PALETTE:預設調色板,該調色板由系統調色板中的靜態色彩組成。
返回值
如果成功,返回值標識申請的邏輯對象,如果失敗,返回值為NULL。
WindowsNT:若想獲得更多錯誤信息,請調用GetLastError函式。
注釋
僅在CS_HREDRAW和CS_VREDRAW風格的視窗中使用DKGRAY_BRUSH、GRAY_BRUSH和LTGRAY_BRUSH對象。
如果在其他風格的視窗中使灰色畫筆,可能導致在視窗移動或改變大小之後出現畫筆模式錯位現象,原始儲存畫筆不能被調整。
HOLLOW_BRUSH和NULL_BRUSH儲存對象相等。
由DEFAULT_GUI_FONT儲存對象使用的字型將改變。當想使用選單、對話框和其他用戶界面對象使用的字型時請使用此儲存對象。
不必要通過調用DeleteObject函式來刪除儲存對象。
Windows 98、Windows NT 5.0和以後版本:DC_BRUSH和DC_PEN都能與其他儲存對象如BLACK_BRUSH和BLACK_PEN相互交換關於檢索當前鋼筆和畫筆顏色的信息,請參見GetDCBrushColor和GetDCPencolor,帶DC BRUSH或DC PEN參數的Getstockobject函式可以與SetDCPenColor和SetDCBrushColor函式相互交換使用。
Windows CE:Windows CE不支持fnObject參數的如下值:
ANSI_FIXED_FONT、ANSI_VAR_FONT、OEM_FIXED_FONT、SYSTEM_FIXED_FONT
Windows CE1.0版本不支持fnObject的DEFAULT_PALETTE值。
速查
Windows NT:3.1及以上版本;
Windows:95及以上版本;
Windows CE:1.0及以上版本;
頭檔案:wingdi.h;
頭檔案:gdi32.lib。