CGdiObject::GetObject

[アーティクル]
08/09/2011

指定したオブジェクトを定義するデータをバッファーに設定します。

int GetObject(
   int nCount,
   LPVOID lpObject 
) const;

パラメーター

nCount
lpObject バッファーにコピーするバイト数を指定します。
lpObject
ユーザーが指定した、情報を受け取るバッファーへのポインター。

戻り値

取得したバイト数を返します。エラーが発生した場合は 0 を返します。

解説

この関数は、次の一覧に示すように、グラフィックオブジェクトの種類に依存する型を持つデータ構造体を取得します。

オブジェクト	バッファーの型
CPen	LOGPEN
CBrush	LOGBRUSH
CFont	LOGFONT
CBitmap	BITMAP
CPalette	WORD
CRgn	サポートなし

オブジェクトが CBitmap オブジェクトの場合、GetObject 関数はビットマップの幅、高さ、カラーフォーマット情報だけを返します。実際のビット列は、CBitmap::GetBitmapBits を使って取得できます。

オブジェクトが CPalette オブジェクトの場合、GetObject 関数はパレットのエントリ数を示す WORD 型の値を取得します。この関数では、パレットを定義する LOGPALETTE 構造体は取得されません。アプリケーションは、CPalette::GetPaletteEntries を使ってパレットエントリに関する情報を取得できます。