GetObjectW 函式 (wingdi.h)

發行項
03/04/2024

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

語法

int GetObjectW(
        HANDLE h,
        int    c,
        LPVOID pv
);

參數

h

c

pv

傳回值

如果函式成功，且 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 會水平繪製。

範例

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

注意

wingdi.h 標頭會將 GetObject 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求

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