GetStockObject

GetStockObject

GetStockObject是一個Windows API函式,該函式檢索預定義的備用筆、刷子、字型或者調色板的句柄,函式原型是HGDIOBJ GetStockObject(int)。

函式功能

該函式檢索預定義的備用筆、刷子、字型或者調色板的句柄。

函式原型

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。

相關詞條

相關搜尋

熱門詞條

聯絡我們