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

現在のデバイス コンテキストのハンドルを取得します。 このプロパティは、ビットマップ画像に対してのみ有効です。

構文

HRESULT get_CurDC(
  [out] HDC *phDC
);

パラメーター

[out] phDC

デバイス コンテキストを受け取る変数を指すポインター。

戻り値

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

リターン コード	説明
S_OK	属性ビットが正常に返されました。
E_POINTER	phDC の値が無効です。 たとえば、 NULL にすることができます。

注釈

CurDC プロパティと IPicture::SelectPicture メソッドは、Windows の制限を回避するために存在します。具体的には、オブジェクトは一度に 1 つのデバイス コンテキストにのみ選択できます。 場合によっては、画像オブジェクトが特定のデバイス コンテキストに永続的に選択される場合があります (たとえば、コントロールで背景に特定の画像を使用する場合があります)。 この画像プロパティを別の場所で使用するには、その古いデバイス コンテキストから一時的に選択解除し、操作の新しいデバイス コンテキストに選択してから、古いデバイス コンテキストに再選択する必要があります。 IPicture::get_CurDC メソッドは、図が現在選択されているデバイス コンテキスト ハンドルを返します。 IPicture::SelectPicture メソッドは、画像を新しいデバイス コンテキストに選択し、古いデバイス コンテキストと図の GDI ハンドルを返します。 呼び出し元は、Windows コードの場合と同様に、呼び出し元が操作を行うときに、古いデバイス コンテキストに戻って画像を選択する必要があります。

呼び出し元へのメモ

呼び出し元は常に、そのコンテキストとピクチャ オブジェクトの間で渡されたデバイス コンテキストを所有します。 図オブジェクトは HDC のコピーを保持するため、呼び出し元は、画面デバイス コンテキストが限られたシステム リソースであるため、(GetDC、CreateDC、または BeginPaint からの) 画面デバイス コンテキストではなく、(CreateCompatibleDC 関数で作成された) メモリ デバイス コンテキストを使用する必要があります。

要件

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

こちらもご覧ください

IPicture

IPicture::SelectPicture