Surface.GetGraphics メソッド

.NET Framework クラス ライブラリ リファレンス

Surface.GetGraphics メソッド

デバイス コンテキストを取得します。

名前空間: Microsoft.WindowsMobile.DirectX.Direct3D
アセンブリ: Microsoft.WindowsMobile.DirectX (microsoft.windowsmobile.directx.dll 内)
構文

Visual Basic (宣言)

Public Function GetGraphics As
 Graphics

Visual Basic (使用法)

Dim instance As Surface
Dim returnValue As Graphics

returnValue = instance.GetGraphics

C#

public Graphics GetGraphics ()

C++

public:
Graphics^ GetGraphics ()

J#

public Graphics GetGraphics ()

JScript

public function GetGraphics () : Graphics

戻り値
サーフェスのデバイス コンテキストを表す Graphics オブジェクト。

例外

例外の種類	条件
InvalidCallException	メソッドの呼び出しが無効です。たとえば、メソッドのパラメータに無効な値が含まれている場合などです。

解説

次の制限が適用されます。

このメソッドは、R5G6B5、X1R5G5B5、R8G8B8、および X8R8G8B8 の各 Format 形式でのみ有効です。Microsoft Windows グラフィックス デバイス インターフェイス (GDI: Graphics Device Interface) の実装はアルファ チャネルでの十分に定義された動作を持たないため、アルファを含む形式はサポートされません。

サーフェイスごとに、一度に 1 つのデバイス コンテキストだけが返されます。

サーフェイスが既にロックされている場合、このメソッドは失敗します。また、サーフェイスが MIPMAP または CUBE MAPのメンバであり、MIPMAP または CUBE MAP の他のメンバがロックされている場合にも失敗します。

レンダリング ターゲットがロック可能なターゲットとして作成されていない限り (または、バック バッファの場合は PresentFlag の LockableBackBuffer を指定して作成されていない限り)、このメソッドは失敗します。

デバイス コンテキストがサーフェイス上で保留状態になっている場合、アプリケーションは次のメソッドを呼び出すことができません。

• ColorFill メソッド

• Device.StretchRectangle メソッド

• Device.UpdateTexture メソッド

• Surface.LockRectangle メソッド

• SwapChain.Present メソッド (サーフェイスを格納しているスワップ チェーンに対して)

• Microsoft.WindowsMobile.DirectX.Direct3D.Texture.LockRectangle メソッド

このメソッドによって暗黙のロックが行われます。デバイス コンテキストは後で使用するために保持されません。デバイス コンテキストを解放するには、ReleaseGraphics を呼び出します。

このメソッドと ReleaseGraphics の呼び出しは、MIPMAP または CUBE MAP のレベルで有効です。ただし、これらの呼び出しは最上位を除くすべての MIP レベルで低速であり、これらの MIP レベルに対する GDI 操作の速度は向上しません。

Graphics オブジェクトは、Microsoft Win32 および GDI 機能へのアクセスを提供します。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Surface クラス
Surface メンバ
Microsoft.WindowsMobile.DirectX.Direct3D 名前空間