Font::FromHfont Method (IntPtr)

 

Creates a Font from the specified Windows handle.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public:
static Font^ FromHfont(
	IntPtr hfont
)

Parameters

hfont
Type: System::IntPtr

A Windows handle to a GDI font.

Return Value

Type: System.Drawing::Font^

The Font this method creates.

Exception Condition
ArgumentException

hfont points to an object that is not a TrueType font.

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. The code performs the following actions:

  • Gets a handle to a GDI font.

  • Creates a Font from that handle.

  • Draws text to the screen, using the new Font.

private:
   [System::Runtime::InteropServices::DllImportAttribute("gdi32.dll")]
   static IntPtr GetStockObject( int fnObject );

public:
   void FromHfont_Example( PaintEventArgs^ e )
   {
      // Get a handle for a GDI font.
      IntPtr hFont = GetStockObject( 17 );

      // Create a Font object from hFont.
      System::Drawing::Font^ hfontFont = System::Drawing::Font::FromHfont( hFont );

      // Use hfontFont to draw text to the screen.
      e->Graphics->DrawString( "This font is from a GDI HFONT", hfontFont, Brushes::Black, 0, 0 );
   }

SecurityPermission

for access to unmanaged code. Related enumeration: UnmanagedCode

.NET Framework
Available since 1.1
Return to top
Show: