IPicture::get_CurDC メソッド (ocidl.h)
現在のデバイス コンテキストのハンドルを取得します。 このプロパティは、ビットマップ画像に対してのみ有効です。
構文
HRESULT get_CurDC(
[out] HDC *phDC
);
パラメーター
[out] phDC
デバイス コンテキストを受け取る変数を指すポインター。
戻り値
このメソッドは、標準の戻り値E_FAILと、次の値をサポートしています。
| リターン コード | 説明 |
|---|---|
|
属性ビットが正常に返されました。 |
|
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 |