Font.ToHfont メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

Font.ToHfont メソッド

この Font を識別するハンドルを返します。

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

Visual Basic (宣言)

Public Function ToHfont As
 IntPtr

Visual Basic (使用法)

Dim instance As Font
Dim returnValue As IntPtr

returnValue = instance.ToHfont

public IntPtr ToHfont ()

C++

public:
IntPtr ToHfont ()

public IntPtr ToHfont ()

JScript

public function ToHfont () : IntPtr

戻り値
この Font を識別する Windows ハンドル。

例外

例外の種類	条件
Win32Exception	操作が失敗しました。

解説

このメソッドを使用する場合は、GDIDeleteObject メソッドを使用して結果として得られる Hfont を廃棄し、確実にリソースが解放されるようにする必要があります。

使用例

Font を作成し、その Font を識別するハンドルを取得するコード例を次に示します。この例は、Windows フォームでの使用を意図してデザインされており、Paint イベントハンドラのパラメータである PaintEventArgse が必要です。

Visual Basic

' Reference the DeleteObject method in the GDI library.
<System.Runtime.InteropServices.DllImportAttribute("GDI32.DLL")>
 _
Private Shared Function
 DeleteObject(ByVal objectHandle As IntPtr)
 As Boolean
End Function

Public Sub ToHfont_Example(ByVal
 e As PaintEventArgs)

    ' Create a Font object.
    Dim myFont As New Font("Arial",
 16)

    ' Get a handle to the Font object.
    Dim hFont As IntPtr = myFont.ToHfont()

    ' Display a message box with the value of hFont.
    MessageBox.Show(hFont.ToString())

    ' Dispose of the hFont.
    DeleteObject(hFont)
End Sub

//Reference the GDI DeleteObject method.
    [System.Runtime.InteropServices.DllImport("GDI32.dll")]
    public static extern bool
 DeleteObject(IntPtr objectHandle); 

    public void ToHfont_Example(PaintEventArgs
 e)
    {
        // Create a Font object.
        Font myFont = new Font("Arial", 16);
                 
        // Get a handle to the Font object.
        IntPtr hFont = myFont.ToHfont();
                 
        // Display a message box with the value of hFont.
        MessageBox.Show(hFont.ToString());
        
        //Dispose of the hFont.
        DeleteObject(hFont);
    }

C++

   //Reference the GDI DeleteObject method.
public:
   [System::Runtime::InteropServices::DllImport("GDI32.dll")]
   static bool DeleteObject( IntPtr objectHandle
 );
   void ToHfont_Example( PaintEventArgs^ /*e*/ )
   {
      // Create a Font object.
      System::Drawing::Font^ myFont = gcnew System::Drawing::Font( "Arial",16
 );

      // Get a handle to the Font object.
      IntPtr hFont = myFont->ToHfont();

      // Display a message box with the value of hFont.
      MessageBox::Show( hFont.ToString() );

      //Dispose of the hFont.
      DeleteObject( hFont );
   }

//Reference the GDI DeleteObject method.
/** @attribute System.Runtime.InteropServices.DllImport("GDI32.dll")
 */
public static native boolean DeleteObject(IntPtr
 objectHandle);

public void ToHfont_Example(PaintEventArgs
 e)
{
    // Create a Font object.
    Font myFont = new Font("Arial", 16);

    // Get a handle to the Font object.
    IntPtr hFont = myFont.ToHfont();

    // Display a message box with the value of hFont.
    MessageBox.Show(hFont.ToString());

    //Dispose of the hFont.
    DeleteObject(hFont);
} //ToHfont_Example