Draw3dText(IntPtr,string,Rectangle,SpecialEffectsTextStyle,SpecialEffectsTextAlignmentFlags,int,int,Color,Color,Color,IntPtr,IntPtr) Method

Summary

Draws three-dimensional text onto the target device context using the specified font, color, and style.

Syntax
C#
VB
C++
  
Public Overloads Sub Draw3dText( _ 
   ByVal hdc As IntPtr, _ 
   ByVal text As String, _ 
   ByVal destRect As Rectangle, _ 
   ByVal textStyle As SpecialEffectsTextStyle, _ 
   ByVal textAlignment As SpecialEffectsTextAlignmentFlags, _ 
   ByVal xDepth As Integer, _ 
   ByVal yDepth As Integer, _ 
   ByVal textColor As Color, _ 
   ByVal shadowColor As Color, _ 
   ByVal hiliteColor As Color, _ 
   ByVal textHfont As IntPtr, _ 
   ByVal foreImageHdc As IntPtr _ 
)  
public void Draw3dText( 
   IntPtr hdc, 
   string text, 
   Rectangle destRect, 
   SpecialEffectsTextStyle textStyle, 
   SpecialEffectsTextAlignmentFlags textAlignment, 
   int xDepth, 
   int yDepth, 
   Color textColor, 
   Color shadowColor, 
   Color hiliteColor, 
   IntPtr textHfont, 
   IntPtr foreImageHdc 
) 
public: 
void Draw3dText(  
   IntPtr hdc, 
   String^ text, 
   Rectangle destRect, 
   SpecialEffectsTextStyle textStyle, 
   SpecialEffectsTextAlignmentFlags textAlignment, 
   int xDepth, 
   int yDepth, 
   Color textColor, 
   Color shadowColor, 
   Color hiliteColor, 
   IntPtr textHfont, 
   IntPtr foreImageHdc 
)  

Parameters

hdc
Handle to a device context.

text
Text string.

destRect
Rectangle to be used as the display destination rectangle.

textStyle
Text style. Use this parameter to control the style and justification of the three-dimensional text. For valid values refer to SpecialEffectsTextStyle.

textAlignment
Text Alignment, For valid values refer to SpecialEffectsTextAlignmentFlags.

xDepth
Horizontal shadow position.

yDepth
Vertical shadow position.

textColor
Text color.

shadowColor
Shadow color.

hiliteColor
Border color.

textHfont
A handle to a System.Drawing.Font object that will be used for drawing the 3D text.

foreImageHdc
a handle to a System.Drawing.Graphics object that will be used to place an image (such as a gradient) on the surface of the three-dimensional text. Use null to paint the color specified in textColor.

Remarks

Use the textStyle and textAlignment parameters to control the style and justification of the three-dimensional text. Use the textFont parameter to place an image (such as a gradient) on the surface of the three-dimensional text.

Drop shadows are available only for the following textStyle values:

  • DropShadow
  • BlockShadow
  • OutlineBlock

shadowColor is available only for the following textStyle values:

  • InsetHeavy
  • InsetExtraHeavy
  • RaisedHeavy
  • RaisedExtraHeavy

hiliteColor is available only for the following textStyle values:

  • InsetLight
  • InsetExtraLight
  • InsetHeavy
  • InsetExtraHeavy
  • RaisedLight
  • RaisedExtraLight
  • RaisedHeavy
  • RaisedExtraHeavy
  • OutlineBlock

For general information, refer to Implementing Special Effects.

Example

This example shows the minimum requirements for using the Draw3dText(Graphics,String,Rectangle,SpecialEffectsTextStyle,SpecialEffectsTextAlignmentFlags,Int32,Int32,Color,Color,Color,Font,Image) method.

C#
VB
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.SpecialEffects; 
using Leadtools.Drawing; 
 
public void Draw3dText(Graphics g, Rectangle destRect) 
{ 
   SpecialEffectsProcessor processor = new SpecialEffectsProcessor(); 
 
   Font textFont = new Font("Arial", 24); 
 
   Image image = Image.FromFile(Path.Combine(LEAD_VARS.ImagesDir, "Ulay1.bmp")); 
 
   processor.Draw3dText(g, 
                        "3D Text - LEADTOOLS", 
                        destRect, 
                        SpecialEffectsTextStyle.DropShadow, 
                        SpecialEffectsTextAlignmentFlags.HorizontalCenter | SpecialEffectsTextAlignmentFlags.VerticalCenter, 
                        2, /* horizontal  shadow position */ 
                        2, /* vertical shadow position */ 
                        Color.Blue, /* text color, blue */ 
                        Color.Black,/* shadow color, black */ 
                        Color.White, /* border color, white */ 
                        textFont, 
                        image); 
 
   image.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.SpecialEffects 
Imports Leadtools.Drawing 
 
Public Sub Draw3dText(ByVal g As Graphics, ByVal destRect As Rectangle) 
   Dim processor As SpecialEffectsProcessor = New SpecialEffectsProcessor() 
 
   Dim textFont As Font = New Font("Arial", 24) 
 
   Dim img As Image = Image.FromFile(Path.Combine(LEAD_VARS.ImagesDir, "Ulay1.bmp")) 
 
   processor.Draw3dText(g, "3D Text - LEADTOOLS", destRect, SpecialEffectsTextStyle.DropShadow, SpecialEffectsTextAlignmentFlags.HorizontalCenter Or 
                        SpecialEffectsTextAlignmentFlags.VerticalCenter, 2, 2, Color.Blue, Color.Black, Color.White, textFont, img) 
 
   img.Dispose() 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class 

Requirements

Target Platforms

Help Version 20.0.2020.3.31
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.SpecialEffects Assembly