Surface.GetGraphics メソッド
[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。 空白のトピックは、プレースホルダーとして挿入されています。]
デバイス コンテキストを取得します。
名前空間: Microsoft.WindowsMobile.DirectX.Direct3D
アセンブリ: Microsoft.WindowsMobile.DirectX (Microsoft.WindowsMobile.DirectX.dll 内)
構文
'宣言
Public Function GetGraphics As Graphics
'使用
Dim instance As Surface
Dim returnValue As Graphics
returnValue = instance.GetGraphics()
public Graphics GetGraphics()
public:
Graphics^ GetGraphics()
member GetGraphics : unit -> Graphics
戻り値
型 : System.Drawing.Graphics
サーフェスのデバイス コンテキストを表す Graphics オブジェクト。
例外
| 例外 | 条件 |
|---|---|
| InvalidCallException | メソッドの呼び出しが無効です。たとえば、メソッドのパラメーターに無効な値が含まれている場合などです。 |
解説
次の制限が適用されます。
このメソッドは、次の Format 形式でのみ有効です。R5G6B5、X1R5G5B5、R8G8B8、および X8R8G8B8。Microsoft Windows グラフィックス デバイス インターフェイス (GDI: Graphics Device Interface) の実装はアルファ チャネルでの十分に定義された動作を持たないため、アルファを含む形式はサポートされません。
サーフェイスごとに、一度に 1 つのデバイス コンテキストだけが返されます。
サーフェイスが既にロックされている場合、このメソッドは失敗します。また、サーフェイスが MIPMAP または CUBE MAPのメンバーであり、MIPMAP または CUBE MAP の他のメンバーがロックされている場合にも失敗します。
レンダリング ターゲットがロック可能なターゲットとして作成されていない限り (または、バック バッファーの場合は LockableBackBuffer の PresentFlag を指定して作成されていない限り)、このメソッドは失敗します。
デバイス コンテキストがサーフェイス上で保留状態になっている場合、アプリケーションは次のメソッドを呼び出すことができません。
ColorFill メソッド
Device.UpdateTexture メソッド
SwapChain.Present メソッド (サーフェイスを格納しているスワップ チェーンに対して)
このメソッドによって暗黙のロックが行われます。デバイス コンテキストは後で使用するために保持されません。デバイス コンテキストを解放するには、ReleaseGraphics を呼び出します。
このメソッドと ReleaseGraphics の呼び出しは、MIPMAP または CUBE MAP のレベルで有効です。ただし、これらの呼び出しは最上位を除くすべての MIP レベルで低速であり、これらの MIP レベルに対する GDI 操作の速度は向上しません。
Graphics オブジェクトは、Microsoft Win32 および GDI 機能へのアクセスを提供します。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分的に信頼される側のコードからライブラリの使用」を参照してください。
プラットフォーム
Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。 サポートされているバージョンについては、「.NET フレームワークのシステム要件」を参照してください。
バージョン情報
.NET Compact Framework
サポート対象 : 3.5、2.0