IPicture::get_hPal メソッド (ocidl.h)

  • [アーティクル]

図オブジェクトで現在使用されているパレットのコピーを取得します。

構文

HRESULT get_hPal(
  [out] OLE_HANDLE *phPal
);

パラメーター

[out] phPal

パレット ハンドルを受け取る変数へのポインター。 失敗した場合、変数は NULL に設定されます。

戻り値

このメソッドは、E_FAILおよびE_OUTOFMEMORYの標準戻り値と、次の値をサポートしています。

リターン コード 説明
S_OK
 高さが正常に返されました。
S_FALSE
 この図にはパレットがありません。 phpal が指す変数が NULL に設定されました。
E_POINTER
 phPal の値が無効です。 たとえば、 NULL にすることができます。

解説

呼び出し元へのメモ

図オブジェクトに図の所有権がある場合は、パレットの所有権も持ち、オブジェクト自体が破棄されると破棄されます。 それ以外の場合、呼び出し元はパレットを所有します。 OleCreatePictureIndirect の fOwn パラメーターによって所有権が決定されます。 OleLoadPictureは、図 オブジェクトがパレットを所有していることを示すために fOwn を TRUE に 設定します。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ocidl.h

関連項目

IPicture