getStockObject 函式 (wingdi.h)
GetStockObject函式會擷取其中一個股票筆、筆刷、字型或調色盤的控制碼。
語法
HGDIOBJ GetStockObject(
[in] int i
);
參數
[in] i
stock 物件的類型。 此參數可以是下列其中一個值。
| 值 | 意義 |
|---|---|
|
黑色筆刷。 |
|
深灰色筆刷。 |
|
純色筆刷。 預設色彩為白色。 您可以使用 SetDCBrushColor 函式來變更色彩。 如需詳細資訊，請參閱＜備註＞一節。 |
|
灰色筆刷。 |
|
空心筆刷 (相當於Null_BRUSH) 。 |
|
淺灰色筆刷。 |
|
Null 筆刷 (相當於 HOLLOW_BRUSH) 。 |
|
白色筆刷。 |
|
黑色畫筆。 |
|
單色筆刷色彩。 預設色彩為黑色。 您可以使用 SetDCPenColor 函式來變更色彩。 如需詳細資訊，請參閱＜備註＞一節。 |
|
Null 畫筆。 Null 畫筆不會繪製任何內容。 |
|
白色畫筆。 |
|
Windows 固定間距 (單空格) 系統字型。 |
|
Windows 可變間距 (比例間距) 系統字型。 |
|
裝置相依字型。 |
|
使用者介面物件的預設字型，例如功能表和對話方塊。 不建議您使用DEFAULT_GUI_FONT或SYSTEM_FONT來取得對話方塊和視窗所使用的字型;如需詳細資訊，請參閱一節。
預設字型為 Tahoma。 |
|
原始設備製造商 (OEM) 相依的固定音調 (單空格) 字型。 |
|
系統字型。 根據預設，系統會使用系統字型來繪製功能表、對話方塊控制項和文字。 不建議您使用DEFAULT_GUI_FONT或SYSTEM_FONT來取得對話方塊和視窗所使用的字型;如需詳細資訊，請參閱一節。
預設系統字型為 Tahoma。 |
|
固定間距 (單空格) 系統字型。 此庫存物件僅供與 3.0 之前的 16 位 Windows 版本相容。 |
|
預設調色盤。 此調色盤是由系統調色盤中的靜態色彩所組成。 |
傳回值
如果函式成功，則傳回值是所要求邏輯物件的控制碼。
如果函式失敗，傳回值為 Null。
備註
不建議使用這個方法來取得對話方塊和視窗所使用的目前字型。 請改用 SystemParametersInfo 函式搭配 SPI_GETNONCLIENTMETRICS 參數來擷取目前的字型。 SystemParametersInfo 會將目前的主題納入考慮，並提供標題、功能表和訊息對話方塊的字型資訊。
請只在具有CS_HREDRAW和CS_VREDRAW樣式的視窗中使用DKGRAY_BRUSH、GRAY_BRUSH和LTGRAY_BRUSH內建物件。 在視窗移動或調整大小之後，使用任何其他樣式的灰色股票筆刷可能會導致筆刷圖樣不對齊。 無法調整股票筆刷的來源。
HOLLOW_BRUSH和Null_BRUSH股票物件相等。
不需要 (，但) 呼叫 DeleteObject來刪除庫存物件並不有害。
DC_BRUSH和DC_PEN可以與其他庫存物件交換使用，例如BLACK_BRUSH和BLACK_PEN。 如需擷取目前畫筆或筆刷色彩的相關資訊，請參閱 GetDCBrushColor 和 GetDCPenColor。 如需設定色彩的範例 ，請參閱設定畫筆或筆刷色彩 。 具有引數的 GetStockObject 函式DC_BRUSH或DC_PEN可以與 SetDCPenColor 和 SetDCBrushColor 函式交替使用。
範例
如需範例，請參閱 設定畫筆或筆刷色彩。
規格需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | wingdi.h (包含 Windows.h) |
| 程式庫 | Gdi32.lib |
| Dll | Gdi32.dll |