TextWidgetAnnotation.MakeBasicAppearance Method |
Makes the basic appearance for the annotation. Unlike
CheckboxWidgetAnnotation,
TextWidgetAnnotation
can't easily share the same appearance since appearances are geometrically scaled to fit the bounds of the annotation.
This means that border outlines will grow or shrink when drawn. When the
Bounds of the
annotation change, the appearance needs to be rebuilt in order to render correctly in the document.
This method is provided so that, for example, client code might add in custom coloring or easily build consistent
appearances for when the annotation has been cliecked on or when it is rolled over.
Namespace:
Atalasoft.PdfDoc.Generating.Annotations
Assembly:
Atalasoft.PdfDoc (in Atalasoft.PdfDoc.dll) Version: 11.4.0.9.0.377 (.NET 4.5.2, x86)
Syntaxpublic static string MakeBasicAppearance(
GlobalResources gr,
PdfBounds bounds,
PdfTextAppearance app,
double borderWidth,
IPdfColor outlineColor,
IPdfColor fillColor,
string value,
bool isMultiline,
AnnotationTextAlignment annotationTextAlignment
)
Public Shared Function MakeBasicAppearance (
gr As GlobalResources,
bounds As PdfBounds,
app As PdfTextAppearance,
borderWidth As Double,
outlineColor As IPdfColor,
fillColor As IPdfColor,
value As String,
isMultiline As Boolean,
annotationTextAlignment As AnnotationTextAlignment
) As String
Parameters
- gr
- Type: Atalasoft.PdfDoc.Generating.ResourceHandling.GlobalResources
The resources that will hold the appearance. - bounds
- Type: Atalasoft.PdfDoc.Geometry.PdfBounds
The bounds of the annotation. - app
- Type: Atalasoft.PdfDoc.Generating.Rendering.PdfTextAppearance
The text appearance for text in the widget. - borderWidth
- Type: System.Double
Width of the border. - outlineColor
- Type: Atalasoft.PdfDoc.Generating.IPdfColor
Color of the outline. - fillColor
- Type: Atalasoft.PdfDoc.Generating.IPdfColor
Color of the fill. - value
- Type: System.String
The text value. - isMultiline
- Type: System.Boolean
A value indicating if this text can contain multiple lines. - annotationTextAlignment
- Type: Atalasoft.PdfDoc.Generating.Annotations.AnnotationTextAlignment
The horizontal alignment of the text.
Return Value
Type:
String
A string which is the name of an template resource that will represent the annotation's appearance.
Examples
If you have
AutoGenerateBasicAppearance set to
true this method will be called as follows:
appearanceName = MakeBasicAppearance(resources, Bounds, DefaultAppearance, borderWidth,
BorderColor ?? PdfColorFactory.FromGray(0), BackgroundColor ?? PdfColorFactory.FromGray(1), TextValue ?? "");
if (this.Appearance == null)
this.Appearance = new AppearanceSet();
this.Appearance.Normal.Add(AppearanceSet.DefaultAppearanceName, appearanceName);
See Also