CGdiObject::GetObject

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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

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 を使ってパレットエントリに関する情報を取得できます。