GetObject 函式 (wingdi.h)

發行項
03/04/2024

GetObject 函式會擷取指定圖形物件的資訊。

語法

int GetObject(
  [in]  HANDLE h,
  [in]  int    c,
  [out] LPVOID pv
);

參數

[in] h

感興趣的圖形物件的句柄。這可以是下列其中一項的句柄：邏輯點陣圖、筆刷、字型、調色盤、手寫筆，或呼叫 CreateDIBSection 函式所建立的裝置獨立位圖。

[in] c

要寫入緩衝區的資訊位元組數目。

[out] pv

緩衝區的指標，接收指定之圖形對象的相關信息。

下表顯示緩衝區針對您可以使用 hgdiobj 指定之每種圖形物件類型接收的資訊類型。

物件型別	寫入緩衝區的數據
HBITMAP	點陣圖
從 CreateDIBSection 呼叫傳回的 HBITMAP	DIBSECTION，如果 cbBuffer 設定為 `sizeof (DIBSECTION)` ，則為 BITMAP，如果 cbBuffer 設定為 `sizeof (BITMAP)`，
HPALETTE	邏輯選擇區中專案的 WORD 計數
HPEN 從對 ExtCreatePen 的呼叫傳回	EXTLOGPEN
HPEN	LOGPEN
HBRUSH	LOGBRUSH
HFONT	LOGFONT

如果 lpvObject 參數為 NULL，則函式傳回值是儲存寫入指定圖形物件之緩衝區之資訊所需的位元組數目。

lpvObject 的地址必須位於 4 位元組界限上;否則，GetObject 會失敗。

傳回值

如果函式成功，且 lpvObject 是有效的指標，則傳回值是儲存在緩衝區中的位元組數目。

如果函式成功，且 lpvObject 為 NULL，則傳回值是保存函式儲存到緩衝區中資訊所需的位元組數目。

如果此函式失敗，則傳回值為零。

備註

lpvObject 參數所指向的緩衝區必須夠大，才能接收圖形對象的相關信息。根據圖形物件，函式會使用 BITMAP、 DIBSECTION、 EXTLOGPEN、 LOGBRUSH、 LOGFONT或 LOGPEN 結構，或邏輯調色盤 (的數據表專案計數) 。

如果 hgdiobj 是呼叫 CreateDIBSection 所建立之位圖的句柄，而且指定的緩衝區夠大， GetObject 函式會傳回 DIBSECTION 結構。此外，DIBSECTION 內含之 BITMAP 結構的 bmBits 成員將包含位圖位值的指標。

如果 hgdiobj 是任何其他方法所建立之點陣圖的句柄， GetObject 只會傳回位圖的寬度、高度和色彩格式資訊。您可以藉由呼叫 GetDIBits 或 GetBitmapBits 函式來取得位陣圖的位值。

如果 hgdiobj 是邏輯調色盤的句柄， GetObject 會擷取指定調色盤中專案的 2 位元組整數。函式不會擷取定義調色盤的 LOGPALETTE 結構。若要擷取調色盤專案的相關信息，應用程式可以呼叫 GetPaletteEntries 函式。

如果 hgdiobj 是字型的句柄，則傳回的 LOGFONT 是用來建立字型的 LOGFONT 。如果 Windows 必須對字型進行一些插補，因為無法表示精確的 LOGFONT ，則插補不會反映在 LOGFONT 中。例如，如果您要求不支援垂直繪製的字型版本， LOGFONT 表示字型是垂直的，但 Windows 會水平繪製。

範例

如需範例，請參閱儲存映像。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll