Font.ToHfont Method

Definition

Returns a handle to this Font.

public IntPtr ToHfont();

Returns

IntPtr

A Windows handle to this Font.

Exceptions

The operation was unsuccessful.

Examples

The following code example creates a Font and then gets a handle to that Font. The example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler.


//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);
    }

Remarks

When using this method, you must dispose of the resulting Hfont using the GDI DeleteObject method to ensure the resources are released.

Applies to