/**
<summary>Creates a new choice field within the given document context.</summary>
*/
protected ChoiceField(
string name,
Widget widget
)
: base(PdfName.Ch, name, widget)
{
}
/**
<summary>Creates a new listbox within the given document context.</summary>
*/
public ListBox(
string name,
Widget widget
)
: base(name,
widget)
{
}
/**
<summary>Creates a new combobox within the given document context.</summary>
*/
public ComboBox(
string name,
Widget widget
)
: base(name, widget)
{
Flags = EnumUtils.Mask(Flags, FlagsEnum.Combo, true);
}
/**
<summary>Creates a new signature field within the given document context.</summary>
*/
//TODO:dictionary mandatory items (if any)!!!
public SignatureField(
string name,
Widget widget
)
: base(PdfName.Sig,
name,
widget)
{
}
/**
<summary>Creates a new checkbox within the given document context.</summary>
*/
public CheckBox(
string name,
Widget widget,
bool checked_
)
: base(name, widget)
{
Checked = checked_;
}
/**
<summary>Creates a new combobox within the given document context.</summary>
*/
public ComboBox(
string name,
Widget widget
)
: base(name,
widget)
{
FlagsEnum flags = Flags; flags |= FlagsEnum.Combo; Flags = flags;
}
/**
<summary>Creates a new button field within the given document context.</summary>
*/
protected ButtonField(
string name,
Widget widget
)
: base(PdfName.Btn,
name,
widget)
{
}
/**
<summary>Creates a new pushbutton within the given document context.</summary>
*/
public PushButton(
string name,
Widget widget,
string caption
)
: base(name, widget)
{
Flags = EnumUtils.Mask(Flags, FlagsEnum.Pushbutton, true);
Value = caption;
}
/**
<summary>Creates a new text field within the given document context.</summary>
*/
public TextField(
string name,
Widget widget,
string value
)
: base(PdfName.Tx,
name,
widget)
{
Value = value;
}
/**
<summary>Creates a new pushbutton within the given document context.</summary>
*/
public PushButton(
string name,
Widget widget,
string caption
)
: base(name,
widget)
{
FlagsEnum flags = Flags; flags |= FlagsEnum.Pushbutton; Flags = flags;
Value = caption;
}
private void Populate(
Document document
)
{
/*
NOTE: In order to insert a field into a document, you have to follow these steps:
1. Define the form fields collection that will gather your fields (NOTE: the form field collection is global to the document);
2. Define the pages where to place the fields;
3. Define the appearance style to render your fields;
4. Create each field of yours:
4.1. instantiate your field into the page;
4.2. apply the appearance style to your field;
4.3. insert your field into the fields collection.
*/
// 1. Define the form fields collection!
Form form = document.Form;
Fields fields = form.Fields;
// 2. Define the page where to place the fields!
Page page = new Page(document);
document.Pages.Add(page);
// 3. Define the appearance style to apply to the fields!
DefaultStyle fieldStyle = new DefaultStyle();
fieldStyle.FontSize = 12;
fieldStyle.GraphicsVisibile = true;
PrimitiveComposer composer = new PrimitiveComposer(page);
composer.SetFont(
new StandardType1Font(
document,
StandardType1Font.FamilyEnum.Courier,
true,
false
),
14
);
// 4. Field creation.
// 4.a. Push button.
{
composer.ShowText(
"PushButton:",
new PointF(140, 68),
XAlignmentEnum.Right,
YAlignmentEnum.Middle,
0
);
Widget fieldWidget = new Widget(
page,
new RectangleF(150, 50, 136, 36)
);
WidgetActions fieldWidgetActions = new WidgetActions(fieldWidget);
fieldWidget.Actions = fieldWidgetActions;
fieldWidgetActions.OnActivate = new JavaScript(
document,
"app.alert(\"Radio button currently selected: '\" + this.getField(\"myRadio\").value + \"'.\",3,0,\"Activation event\");"
);
PushButton field = new PushButton(
"okButton",
fieldWidget,
"Push" // Current value.
); // 4.1. Field instantiation.
fields.Add(field); // 4.2. Field insertion into the fields collection.
fieldStyle.Apply(field); // 4.3. Appearance style applied.
{
BlockComposer blockComposer = new BlockComposer(composer);
blockComposer.Begin(new RectangleF(296,50,page.Size.Width-336,36),XAlignmentEnum.Left,YAlignmentEnum.Middle);
composer.SetFont(composer.State.Font,7);
blockComposer.ShowText("If you click this push button, a javascript action should prompt you an alert box responding to the activation event triggered by your PDF viewer.");
blockComposer.End();
}
}
// 4.b. Check box.
{
composer.ShowText(
"CheckBox:",
new PointF(140, 118),
XAlignmentEnum.Right,
YAlignmentEnum.Middle,
0
);
CheckBox field = new CheckBox(
"myCheck",
new Widget(
page,
new RectangleF(150, 100, 36, 36)
),
true // Current value.
); // 4.1. Field instantiation.
fieldStyle.Apply(field);
fields.Add(field);
field = new CheckBox(
"myCheck2",
new Widget(
page,
new RectangleF(200, 100, 36, 36)
),
true // Current value.
); // 4.1. Field instantiation.
fieldStyle.Apply(field);
fields.Add(field);
field = new CheckBox(
"myCheck3",
new Widget(
page,
new RectangleF(250, 100, 36, 36)
),
false // Current value.
); // 4.1. Field instantiation.
fields.Add(field); // 4.2. Field insertion into the fields collection.
fieldStyle.Apply(field); // 4.3. Appearance style applied.
}
// 4.c. Radio button.
{
composer.ShowText(
"RadioButton:",
new PointF(140, 168),
XAlignmentEnum.Right,
YAlignmentEnum.Middle,
0
);
RadioButton field = new RadioButton(
"myRadio",
/*
NOTE: A radio button field typically combines multiple alternative widgets.
*/
new DualWidget[]
{
new DualWidget(
page,
new RectangleF(150, 150, 36, 36),
"first"
),
new DualWidget(
page,
new RectangleF(200, 150, 36, 36),
"second"
),
new DualWidget(
page,
new RectangleF(250, 150, 36, 36),
"third"
)
},
"second" // Selected item (it MUST correspond to one of the available widgets' names).
); // 4.1. Field instantiation.
fields.Add(field); // 4.2. Field insertion into the fields collection.
fieldStyle.Apply(field); // 4.3. Appearance style applied.
}
// 4.d. Text field.
{
composer.ShowText(
"TextField:",
new PointF(140, 218),
XAlignmentEnum.Right,
YAlignmentEnum.Middle,
0
);
TextField field = new TextField(
"myText",
new Widget(
page,
new RectangleF(150, 200, 200, 36)
),
"Carmen Consoli" // Current value.
); // 4.1. Field instantiation.
field.SpellChecked = false; // Avoids text spell check.
FieldActions fieldActions = new FieldActions(document);
field.Actions = fieldActions;
fieldActions.OnValidate = new JavaScript(
document,
"app.alert(\"Text '\" + this.getField(\"myText\").value + \"' has changed!\",3,0,\"Validation event\");"
);
fields.Add(field); // 4.2. Field insertion into the fields collection.
fieldStyle.Apply(field); // 4.3. Appearance style applied.
{
BlockComposer blockComposer = new BlockComposer(composer);
blockComposer.Begin(new RectangleF(360,200,page.Size.Width-400,36),XAlignmentEnum.Left,YAlignmentEnum.Middle);
composer.SetFont(composer.State.Font,7);
blockComposer.ShowText("If you leave this text field after changing its content, a javascript action should prompt you an alert box responding to the validation event triggered by your PDF viewer.");
blockComposer.End();
}
}
// 4.e. Choice fields.
{
// Preparing the item list that we'll use for choice fields (a list box and a combo box (see below))...
ChoiceItems items = new ChoiceItems(document);
items.Add("Tori Amos");
items.Add("Anouk");
items.Add("Joan Baez");
items.Add("Rachele Bastreghi");
items.Add("Anna Calvi");
items.Add("Tracy Chapman");
items.Add("Carmen Consoli");
items.Add("Ani DiFranco");
items.Add("Cristina Dona'");
items.Add("Nathalie Giannitrapani");
items.Add("PJ Harvey");
items.Add("Billie Holiday");
items.Add("Joan As Police Woman");
items.Add("Joan Jett");
items.Add("Janis Joplin");
items.Add("Angelique Kidjo");
items.Add("Patrizia Laquidara");
items.Add("Annie Lennox");
items.Add("Loreena McKennitt");
items.Add("Joni Mitchell");
items.Add("Alanis Morissette");
items.Add("Yael Naim");
items.Add("Noa");
items.Add("Sinead O'Connor");
items.Add("Dolores O'Riordan");
items.Add("Nina Persson");
items.Add("Brisa Roche'");
items.Add("Roberta Sammarelli");
items.Add("Cristina Scabbia");
items.Add("Nina Simone");
items.Add("Skin");
items.Add("Patti Smith");
items.Add("Fatima Spar");
items.Add("Thony (F.V.Caiozzo)");
items.Add("Paola Turci");
items.Add("Sarah Vaughan");
items.Add("Nina Zilli");
// 4.e1. List box.
{
composer.ShowText(
"ListBox:",
new PointF(140, 268),
XAlignmentEnum.Right,
YAlignmentEnum.Middle,
0
);
ListBox field = new ListBox(
"myList",
new Widget(
page,
new RectangleF(150, 250, 200, 70)
)
); // 4.1. Field instantiation.
field.Items = items; // List items assignment.
field.MultiSelect = false; // Multiple items may not be selected simultaneously.
field.Value = "Carmen Consoli"; // Selected item.
fields.Add(field); // 4.2. Field insertion into the fields collection.
fieldStyle.Apply(field); // 4.3. Appearance style applied.
}
// 4.e2. Combo box.
{
composer.ShowText(
"ComboBox:",
new PointF(140, 350),
XAlignmentEnum.Right,
YAlignmentEnum.Middle,
0
);
ComboBox field = new ComboBox(
"myCombo",
new Widget(
page,
new RectangleF(150, 334, 200, 36)
)
); // 4.1. Field instantiation.
field.Items = items; // Combo items assignment.
field.Editable = true; // Text may be edited.
field.SpellChecked = false; // Avoids text spell check.
field.Value = "Carmen Consoli"; // Selected item.
fields.Add(field); // 4.2. Field insertion into the fields collection.
fieldStyle.Apply(field); // 4.3. Appearance style applied.
}
}
composer.Flush();
}
