getStockObject 函式 (wingdi.h)

  • 發行項

GetStockObject函式會擷取其中一個股票筆、筆刷、字型或調色盤的控制碼。

語法

HGDIOBJ GetStockObject(
  [in] int i
);

參數

[in] i

stock 物件的類型。 此參數可以是下列其中一個值。

值 意義
BLACK_BRUSH
 黑色筆刷。
DKGRAY_BRUSH
 深灰色筆刷。
DC_BRUSH
 純色筆刷。 預設色彩為白色。 您可以使用 SetDCBrushColor 函式來變更色彩。 如需詳細資訊，請參閱＜備註＞一節。
GRAY_BRUSH
 灰色筆刷。
HOLLOW_BRUSH
 空心筆刷 (相當於Null_BRUSH) 。
LTGRAY_BRUSH
 淺灰色筆刷。
Null_BRUSH
 Null 筆刷 (相當於 HOLLOW_BRUSH) 。
WHITE_BRUSH
 白色筆刷。
BLACK_PEN
 黑色畫筆。
DC_PEN
 單色筆刷色彩。 預設色彩為黑色。 您可以使用 SetDCPenColor 函式來變更色彩。 如需詳細資訊，請參閱＜備註＞一節。
Null_PEN
 Null 畫筆。 Null 畫筆不會繪製任何內容。
WHITE_PEN
 白色畫筆。
ANSI_FIXED_FONT
 Windows 固定間距 (單空格) 系統字型。
ANSI_VAR_FONT
 Windows 可變間距 (比例間距) 系統字型。
DEVICE_DEFAULT_FONT
 裝置相依字型。
DEFAULT_GUI_FONT
 使用者介面物件的預設字型，例如功能表和對話方塊。 不建議您使用DEFAULT_GUI_FONT或SYSTEM_FONT來取得對話方塊和視窗所使用的字型;如需詳細資訊，請參閱一節。

預設字型為 Tahoma。
OEM_FIXED_FONT
 原始設備製造商 (OEM) 相依的固定音調 (單空格) 字型。
SYSTEM_FONT
 系統字型。 根據預設，系統會使用系統字型來繪製功能表、對話方塊控制項和文字。 不建議您使用DEFAULT_GUI_FONT或SYSTEM_FONT來取得對話方塊和視窗所使用的字型;如需詳細資訊，請參閱一節。

預設系統字型為 Tahoma。
SYSTEM_FIXED_FONT
 固定間距 (單空格) 系統字型。 此庫存物件僅供與 3.0 之前的 16 位 Windows 版本相容。
DEFAULT_PALETTE
 預設調色盤。 此調色盤是由系統調色盤中的靜態色彩所組成。

傳回值

如果函式成功，則傳回值是所要求邏輯物件的控制碼。

如果函式失敗，傳回值為 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

另請參閱

DeleteObject

裝置內容函式

裝置內容概觀

SelectObject