Graphics.GetHalftonePalette メソッド

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

Graphics.GetHalftonePalette メソッド

現在の Windows ハーフトーン パレットを識別するハンドルを取得します。

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Shared Function GetHalftonePalette
 As IntPtr

Visual Basic (使用法)

Dim returnValue As IntPtr

returnValue = Graphics.GetHalftonePalette

C#

public static IntPtr GetHalftonePalette ()

C++

public:
static IntPtr GetHalftonePalette ()

J#

public static IntPtr GetHalftonePalette ()

JScript

public static function GetHalftonePalette
 () : IntPtr

戻り値
パレットを識別するハンドルを指定する内部ポインタ。

解説

GetHalftonePalette メソッドの目的は、8 ビット/ピクセルの表示を使用する場合に GDI+ で生成するハーフトーンの品質を向上させることです。ハーフトーン パレットを使用してイメージを表示するには、次の手順に従います。

使用例

次の例は、Windows フォームでの使用を意図してデザインされており、Paint イベント ハンドラのパラメータである PaintEventArgse が必要です。このコードは次のアクションを実行します。

• 必要な GDI 関数が格納された、Windows DLL ファイル gdi32.dll の相互運用性 DllImportAttribute 属性を定義します。

• その DLL の SelectPalette 関数と RealizePalette 関数を外部関数として定義します。

• 既存のイメージ ファイル SampImag.jpg (サンプルのコード ファイルと同じフォルダに置く必要があります) からイメージを作成し、画面にそのイメージを描画します。

• 内部ポインタ型変数を作成し、それらの値をグラフィックス オブジェクトを識別するハンドルと、現在の Windows ハーフトーン パレットを識別するハンドルにそれぞれ設定します。

• ハーフトーン パレットを選択および認識します。

• hdc パラメータを使用して、新しいグラフィックス オブジェクトを作成します。

• イメージを再度描画します。

• デバイス コンテキストを識別するハンドルを解放します。

16 ビット パレットと 8 ビット パレットを使用して、サンプル イメージの 2 つのレンダリングが生成されます。

Visual Basic

<System.Runtime.InteropServices.DllImportAttribute("gdi32.dll")>
 _
Private Shared Function
 SelectPalette(ByVal hdc As IntPtr, _
ByVal htPalette As IntPtr, ByVal
 bForceBackground As Boolean) As
 IntPtr
End Function

<System.Runtime.InteropServices.DllImportAttribute("gdi32.dll")>
 _
Private Shared Function
 RealizePalette(ByVal hdc As IntPtr) As
 Integer
End Function

<System.Security.Permissions.SecurityPermission( _
System.Security.Permissions.SecurityAction.LinkDemand, Flags := _
System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)> _
Public Sub GetHalftonePaletteVoid(ByVal
 e As PaintEventArgs)

    ' Create and draw image.
    Dim imageFile As Image = Image.FromFile("SampImag.jpg")
    e.Graphics.DrawImage(imageFile, New Point(0, 0))

    ' Get handle to device context.
    Dim hdc As IntPtr = e.Graphics.GetHdc()

    ' Get handle to halftone palette.
    Dim htPalette As IntPtr = Graphics.GetHalftonePalette()

    ' Select and realize new palette.
    SelectPalette(hdc, htPalette, True)
    RealizePalette(hdc)

    ' Create new graphics object.
    Dim newGraphics As Graphics = Graphics.FromHdc(hdc)

    ' Draw image with new palette.
    newGraphics.DrawImage(imageFile, 300, 0)

    ' Release handle to device context.
    e.Graphics.ReleaseHdc(hdc)
End Sub

C#

[System.Runtime.InteropServices.DllImportAttribute("gdi32.dll")]
private static extern IntPtr SelectPalette(
    IntPtr hdc,
    IntPtr htPalette,
    bool bForceBackground);
[System.Runtime.InteropServices.DllImportAttribute("gdi32.dll")]
private static extern int
 RealizePalette(IntPtr hdc);

[System.Security.Permissions.SecurityPermission(
System.Security.Permissions.SecurityAction.LinkDemand, Flags = 
System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)]            
public void GetHalftonePaletteVoid(PaintEventArgs
 e)
{

    // Create and draw image.
    Image imageFile = Image.FromFile("SampImag.jpg");
    e.Graphics.DrawImage(imageFile, new Point(0, 0));

    // Get handle to device context.
    IntPtr hdc = e.Graphics.GetHdc();

    // Get handle to halftone palette.
    IntPtr htPalette = Graphics.GetHalftonePalette();

    // Select and realize new palette.
    SelectPalette(hdc, htPalette, true);
    RealizePalette(hdc);

    // Create new graphics object.
    Graphics newGraphics = Graphics.FromHdc(hdc);

    // Draw image with new palette.
    newGraphics.DrawImage(imageFile, 300, 0);

    // Release handle to device context.
    e.Graphics.ReleaseHdc(hdc);
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Graphics クラス
Graphics メンバ
System.Drawing 名前空間