GetObjectW 函式（wingdi.h）

發行項
11/20/2024

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

語法

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

參數

h

c

pv

傳回值

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

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

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

言論

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

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

如果 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 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	wingdi.h （包括 Windows.h）
連結庫	Gdi32.lib
DLL	Gdi32.dll