com.aowagie.text.pdf.PushbuttonField Maven / Gradle / Ivy
/*
* Copyright 2005 by Paulo Soares.
*
* The contents of this file are subject to the Mozilla Public License Version 1.1
* (the "License"); you may not use this file except in compliance with the License.
* You may obtain a copy of the License at http://www.mozilla.org/MPL/
*
* Software distributed under the License is distributed on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
* for the specific language governing rights and limitations under the License.
*
* The Original Code is 'iText, a free JAVA-PDF library'.
*
* The Initial Developer of the Original Code is Bruno Lowagie. Portions created by
* the Initial Developer are Copyright (C) 1999, 2000, 2001, 2002 by Bruno Lowagie.
* All Rights Reserved.
* Co-Developer of the code is Paulo Soares. Portions created by the Co-Developer
* are Copyright (C) 2000, 2001, 2002 by Paulo Soares. All Rights Reserved.
*
* Contributor(s): all the names of the contributors are added in the source code
* where applicable.
*
* Alternatively, the contents of this file may be used under the terms of the
* LGPL license (the "GNU LIBRARY GENERAL PUBLIC LICENSE"), in which case the
* provisions of LGPL are applicable instead of those above. If you wish to
* allow use of your version of this file only under the terms of the LGPL
* License and not to allow others to use your version of this file under
* the MPL, indicate your decision by deleting the provisions above and
* replace them with the notice and other provisions required by the LGPL.
* If you do not delete the provisions above, a recipient may use your version
* of this file under either the MPL or the GNU LIBRARY GENERAL PUBLIC LICENSE.
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the MPL as stated above or under the terms of the GNU
* Library General Public License as published by the Free Software Foundation;
* either version 2 of the License, or any later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Library general Public License for more
* details.
*
* If you didn't download this code from the following link, you should check if
* you aren't using an obsolete version:
* http://www.lowagie.com/iText/
*/
package com.aowagie.text.pdf;
import java.io.IOException;
import com.aowagie.text.DocumentException;
import com.aowagie.text.Image;
import com.aowagie.text.Rectangle;
/**
* Creates a pushbutton field. It supports all the text and icon alignments.
* The icon may be an image or a template.
*
* Example usage:
*
*
* Document document = new Document(PageSize.A4, 50, 50, 50, 50);
* PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream("output.pdf"));
* document.open();
* PdfContentByte cb = writer.getDirectContent();
* Image img = Image.getInstance("image.png");
* PushbuttonField bt = new PushbuttonField(writer, new Rectangle(100, 100, 200, 200), "Button1");
* bt.setText("My Caption");
* bt.setFontSize(0);
* bt.setImage(img);
* bt.setLayout(PushbuttonField.LAYOUT_ICON_TOP_LABEL_BOTTOM);
* bt.setBackgroundColor(Color.cyan);
* bt.setBorderStyle(PdfBorderDictionary.STYLE_SOLID);
* bt.setBorderColor(Color.red);
* bt.setBorderWidth(3);
* PdfFormField ff = bt.getField();
* PdfAction ac = PdfAction.createSubmitForm("http://www.submit-site.com", null, 0);
* ff.setAction(ac);
* writer.addAnnotation(ff);
* document.close();
*
* @author Paulo Soares ([email protected])
*/
class PushbuttonField extends BaseField {
/** A layout option */
private static final int LAYOUT_LABEL_ONLY = 1;
/** A layout option */
private static final int LAYOUT_ICON_ONLY = 2;
/** A layout option */
private static final int LAYOUT_ICON_TOP_LABEL_BOTTOM = 3;
/** A layout option */
private static final int LAYOUT_LABEL_TOP_ICON_BOTTOM = 4;
/** A layout option */
private static final int LAYOUT_ICON_LEFT_LABEL_RIGHT = 5;
/** A layout option */
private static final int LAYOUT_LABEL_LEFT_ICON_RIGHT = 6;
/** A layout option */
private static final int LAYOUT_LABEL_OVER_ICON = 7;
/** An icon scaling option */
static final int SCALE_ICON_ALWAYS = 1;
/** An icon scaling option */
static final int SCALE_ICON_NEVER = 2;
/** An icon scaling option */
static final int SCALE_ICON_IS_TOO_BIG = 3;
/** An icon scaling option */
static final int SCALE_ICON_IS_TOO_SMALL = 4;
/**
* Holds value of property layout.
*/
private int layout = LAYOUT_LABEL_ONLY;
/**
* Holds value of property image.
*/
private Image image;
/**
* Holds value of property template.
*/
private PdfTemplate template;
/**
* Holds value of property scaleIcon.
*/
private int scaleIcon = SCALE_ICON_ALWAYS;
/**
* Holds value of property proportionalIcon.
*/
private boolean proportionalIcon = true;
/**
* Holds value of property iconVerticalAdjustment.
*/
private float iconVerticalAdjustment = 0.5f;
/**
* Holds value of property iconHorizontalAdjustment.
*/
private float iconHorizontalAdjustment = 0.5f;
/**
* Holds value of property iconFitToBounds.
*/
private boolean iconFitToBounds;
private PdfTemplate tp;
/**
* Creates a new instance of PushbuttonField
* @param writer the document PdfWriter
* @param box the field location and dimensions
* @param fieldName the field name. If null only the widget keys
* will be included in the field allowing it to be used as a kid field.
*/
PushbuttonField(final PdfWriter writer, final Rectangle box, final String fieldName) {
super(writer, box, fieldName);
}
/**
* Getter for property layout.
* @return Value of property layout.
*/
public int getLayout() {
return this.layout;
}
/**
* Sets the icon and label layout. Possible values are LAYOUT_LABEL_ONLY,
* LAYOUT_ICON_ONLY, LAYOUT_ICON_TOP_LABEL_BOTTOM,
* LAYOUT_LABEL_TOP_ICON_BOTTOM, LAYOUT_ICON_LEFT_LABEL_RIGHT,
* LAYOUT_LABEL_LEFT_ICON_RIGHT and LAYOUT_LABEL_OVER_ICON.
* The default is LAYOUT_LABEL_ONLY.
* @param layout New value of property layout.
*/
public void setLayout(final int layout) {
if (layout < LAYOUT_LABEL_ONLY || layout > LAYOUT_LABEL_OVER_ICON) {
throw new IllegalArgumentException("Layout out of bounds.");
}
this.layout = layout;
}
/**
* Getter for property image.
* @return Value of property image.
*/
public Image getImage() {
return this.image;
}
/**
* Sets the icon as an image.
* @param image the image
*/
public void setImage(final Image image) {
this.image = image;
this.template = null;
}
/**
* Getter for property template.
* @return Value of property template.
*/
public PdfTemplate getTemplate() {
return this.template;
}
/**
* Sets the icon as a template.
* @param template the template
*/
public void setTemplate(final PdfTemplate template) {
this.template = template;
this.image = null;
}
/**
* Getter for property scaleIcon.
* @return Value of property scaleIcon.
*/
public int getScaleIcon() {
return this.scaleIcon;
}
/**
* Sets the way the icon will be scaled. Possible values are
* SCALE_ICON_ALWAYS, SCALE_ICON_NEVER,
* SCALE_ICON_IS_TOO_BIG and SCALE_ICON_IS_TOO_SMALL.
* The default is SCALE_ICON_ALWAYS.
* @param scaleIcon the way the icon will be scaled
*/
public void setScaleIcon(int scaleIcon) {
if (scaleIcon < SCALE_ICON_ALWAYS || scaleIcon > SCALE_ICON_IS_TOO_SMALL) {
scaleIcon = SCALE_ICON_ALWAYS;
}
this.scaleIcon = scaleIcon;
}
/**
* Getter for property proportionalIcon.
* @return Value of property proportionalIcon.
*/
public boolean isProportionalIcon() {
return this.proportionalIcon;
}
/**
* Sets the way the icon is scaled. If true the icon is scaled proportionally,
* if false the scaling is done anamorphicaly.
* @param proportionalIcon the way the icon is scaled
*/
public void setProportionalIcon(final boolean proportionalIcon) {
this.proportionalIcon = proportionalIcon;
}
/**
* Getter for property iconVerticalAdjustment.
* @return Value of property iconVerticalAdjustment.
*/
public float getIconVerticalAdjustment() {
return this.iconVerticalAdjustment;
}
/**
* A number between 0 and 1 indicating the fraction of leftover space to allocate at the bottom of the icon.
* A value of 0 positions the icon at the bottom of the annotation rectangle.
* A value of 0.5 centers it within the rectangle. The default is 0.5.
* @param iconVerticalAdjustment a number between 0 and 1 indicating the fraction of leftover space to allocate at the bottom of the icon
*/
public void setIconVerticalAdjustment(float iconVerticalAdjustment) {
if (iconVerticalAdjustment < 0) {
iconVerticalAdjustment = 0;
} else if (iconVerticalAdjustment > 1) {
iconVerticalAdjustment = 1;
}
this.iconVerticalAdjustment = iconVerticalAdjustment;
}
/**
* Getter for property iconHorizontalAdjustment.
* @return Value of property iconHorizontalAdjustment.
*/
public float getIconHorizontalAdjustment() {
return this.iconHorizontalAdjustment;
}
/**
* A number between 0 and 1 indicating the fraction of leftover space to allocate at the left of the icon.
* A value of 0 positions the icon at the left of the annotation rectangle.
* A value of 0.5 centers it within the rectangle. The default is 0.5.
* @param iconHorizontalAdjustment a number between 0 and 1 indicating the fraction of leftover space to allocate at the left of the icon
*/
public void setIconHorizontalAdjustment(float iconHorizontalAdjustment) {
if (iconHorizontalAdjustment < 0) {
iconHorizontalAdjustment = 0;
} else if (iconHorizontalAdjustment > 1) {
iconHorizontalAdjustment = 1;
}
this.iconHorizontalAdjustment = iconHorizontalAdjustment;
}
private float calculateFontSize(final float w, final float h) throws IOException, DocumentException {
final BaseFont ufont = getRealFont();
float fsize = this.fontSize;
if (fsize == 0) {
final float bw = ufont.getWidthPoint(this.text, 1);
if (bw == 0) {
fsize = 12;
} else {
fsize = w / bw;
}
final float nfsize = h / (1 - ufont.getFontDescriptor(BaseFont.DESCENT, 1));
fsize = Math.min(fsize, nfsize);
if (fsize < 4) {
fsize = 4;
}
}
return fsize;
}
/**
* Gets the button appearance.
* @throws IOException on error
* @throws DocumentException on error
* @return the button appearance
*/
public PdfAppearance getAppearance() throws IOException, DocumentException {
final PdfAppearance app = getBorderAppearance();
final Rectangle box = new Rectangle(app.getBoundingBox());
if ((this.text == null || this.text.length() == 0) && (this.layout == LAYOUT_LABEL_ONLY || this.image == null && this.template == null && this.iconReference == null)) {
return app;
}
if (this.layout == LAYOUT_ICON_ONLY && this.image == null && this.template == null && this.iconReference == null) {
return app;
}
final BaseFont ufont = getRealFont();
final boolean borderExtra = this.borderStyle == PdfBorderDictionary.STYLE_BEVELED || this.borderStyle == PdfBorderDictionary.STYLE_INSET;
float h = box.getHeight() - this.borderWidth * 2;
float bw2 = this.borderWidth;
if (borderExtra) {
h -= this.borderWidth * 2;
bw2 *= 2;
}
float offsetX = borderExtra ? 2 * this.borderWidth : this.borderWidth;
offsetX = Math.max(offsetX, 1);
final float offX = Math.min(bw2, offsetX);
this.tp = null;
float textX = Float.NaN;
float textY = 0;
float fsize = this.fontSize;
final float wt = box.getWidth() - 2 * offX - 2;
final float ht = box.getHeight() - 2 * offX;
final float adj = this.iconFitToBounds ? 0 : offX + 1;
int nlayout = this.layout;
if (this.image == null && this.template == null && this.iconReference == null) {
nlayout = LAYOUT_LABEL_ONLY;
}
Rectangle iconBox = null;
while (true) {
switch (nlayout) {
case LAYOUT_LABEL_ONLY:
case LAYOUT_LABEL_OVER_ICON:
if (this.text != null && this.text.length() > 0 && wt > 0 && ht > 0) {
fsize = calculateFontSize(wt, ht);
textX = (box.getWidth() - ufont.getWidthPoint(this.text, fsize)) / 2;
textY = (box.getHeight() - ufont.getFontDescriptor(BaseFont.ASCENT, fsize)) / 2;
}
case LAYOUT_ICON_ONLY:
if (nlayout == LAYOUT_LABEL_OVER_ICON || nlayout == LAYOUT_ICON_ONLY) {
iconBox = new Rectangle(box.getLeft() + adj, box.getBottom() + adj, box.getRight() - adj, box.getTop() - adj);
}
break;
case LAYOUT_ICON_TOP_LABEL_BOTTOM:
if (this.text == null || this.text.length() == 0 || wt <= 0 || ht <= 0) {
nlayout = LAYOUT_ICON_ONLY;
continue;
}
float nht = box.getHeight() * 0.35f - offX;
if (nht > 0) {
fsize = calculateFontSize(wt, nht);
} else {
fsize = 4;
}
textX = (box.getWidth() - ufont.getWidthPoint(this.text, fsize)) / 2;
textY = offX - ufont.getFontDescriptor(BaseFont.DESCENT, fsize);
iconBox = new Rectangle(box.getLeft() + adj, textY + fsize, box.getRight() - adj, box.getTop() - adj);
break;
case LAYOUT_LABEL_TOP_ICON_BOTTOM:
if (this.text == null || this.text.length() == 0 || wt <= 0 || ht <= 0) {
nlayout = LAYOUT_ICON_ONLY;
continue;
}
nht = box.getHeight() * 0.35f - offX;
if (nht > 0) {
fsize = calculateFontSize(wt, nht);
} else {
fsize = 4;
}
textX = (box.getWidth() - ufont.getWidthPoint(this.text, fsize)) / 2;
textY = box.getHeight() - offX - fsize;
if (textY < offX) {
textY = offX;
}
iconBox = new Rectangle(box.getLeft() + adj, box.getBottom() + adj, box.getRight() - adj, textY + ufont.getFontDescriptor(BaseFont.DESCENT, fsize));
break;
case LAYOUT_LABEL_LEFT_ICON_RIGHT:
if (this.text == null || this.text.length() == 0 || wt <= 0 || ht <= 0) {
nlayout = LAYOUT_ICON_ONLY;
continue;
}
float nw = box.getWidth() * 0.35f - offX;
if (nw > 0) {
fsize = calculateFontSize(wt, nw);
} else {
fsize = 4;
}
if (ufont.getWidthPoint(this.text, fsize) >= wt) {
nlayout = LAYOUT_LABEL_ONLY;
fsize = this.fontSize;
continue;
}
textX = offX + 1;
textY = (box.getHeight() - ufont.getFontDescriptor(BaseFont.ASCENT, fsize)) / 2;
iconBox = new Rectangle(textX + ufont.getWidthPoint(this.text, fsize), box.getBottom() + adj, box.getRight() - adj, box.getTop() - adj);
break;
case LAYOUT_ICON_LEFT_LABEL_RIGHT:
if (this.text == null || this.text.length() == 0 || wt <= 0 || ht <= 0) {
nlayout = LAYOUT_ICON_ONLY;
continue;
}
nw = box.getWidth() * 0.35f - offX;
if (nw > 0) {
fsize = calculateFontSize(wt, nw);
} else {
fsize = 4;
}
if (ufont.getWidthPoint(this.text, fsize) >= wt) {
nlayout = LAYOUT_LABEL_ONLY;
fsize = this.fontSize;
continue;
}
textX = box.getWidth() - ufont.getWidthPoint(this.text, fsize) - offX - 1;
textY = (box.getHeight() - ufont.getFontDescriptor(BaseFont.ASCENT, fsize)) / 2;
iconBox = new Rectangle(box.getLeft() + adj, box.getBottom() + adj, textX - 1, box.getTop() - adj);
break;
}
break;
}
if (textY < box.getBottom() + offX) {
textY = box.getBottom() + offX;
}
if (iconBox != null && (iconBox.getWidth() <= 0 || iconBox.getHeight() <= 0)) {
iconBox = null;
}
boolean haveIcon = false;
float boundingBoxWidth = 0;
float boundingBoxHeight = 0;
PdfArray matrix = null;
if (iconBox != null) {
if (this.image != null) {
this.tp = new PdfTemplate(this.writer);
this.tp.setBoundingBox(new Rectangle(this.image));
this.writer.addDirectTemplateSimple(this.tp, PdfName.FRM);
this.tp.addImage(this.image, this.image.getWidth(), 0, 0, this.image.getHeight(), 0, 0);
haveIcon = true;
boundingBoxWidth = this.tp.getBoundingBox().getWidth();
boundingBoxHeight = this.tp.getBoundingBox().getHeight();
}
else if (this.template != null) {
this.tp = new PdfTemplate(this.writer);
this.tp.setBoundingBox(new Rectangle(this.template.getWidth(), this.template.getHeight()));
this.writer.addDirectTemplateSimple(this.tp, PdfName.FRM);
this.tp.addTemplate(this.template, this.template.getBoundingBox().getLeft(), this.template.getBoundingBox().getBottom());
haveIcon = true;
boundingBoxWidth = this.tp.getBoundingBox().getWidth();
boundingBoxHeight = this.tp.getBoundingBox().getHeight();
}
else if (this.iconReference != null) {
final PdfDictionary dic = (PdfDictionary)PdfReader.getPdfObject(this.iconReference);
if (dic != null) {
final Rectangle r2 = PdfReader.getNormalizedRectangle(dic.getAsArray(PdfName.BBOX));
matrix = dic.getAsArray(PdfName.MATRIX);
haveIcon = true;
boundingBoxWidth = r2.getWidth();
boundingBoxHeight = r2.getHeight();
}
}
}
if (haveIcon) {
float icx = iconBox.getWidth() / boundingBoxWidth;
float icy = iconBox.getHeight() / boundingBoxHeight;
if (this.proportionalIcon) {
switch (this.scaleIcon) {
case SCALE_ICON_IS_TOO_BIG:
icx = Math.min(icx, icy);
icx = Math.min(icx, 1);
break;
case SCALE_ICON_IS_TOO_SMALL:
icx = Math.min(icx, icy);
icx = Math.max(icx, 1);
break;
case SCALE_ICON_NEVER:
icx = 1;
break;
default:
icx = Math.min(icx, icy);
break;
}
icy = icx;
}
else {
switch (this.scaleIcon) {
case SCALE_ICON_IS_TOO_BIG:
icx = Math.min(icx, 1);
icy = Math.min(icy, 1);
break;
case SCALE_ICON_IS_TOO_SMALL:
icx = Math.max(icx, 1);
icy = Math.max(icy, 1);
break;
case SCALE_ICON_NEVER:
icx = icy = 1;
break;
default:
break;
}
}
final float xpos = iconBox.getLeft() + (iconBox.getWidth() - boundingBoxWidth * icx) * this.iconHorizontalAdjustment;
final float ypos = iconBox.getBottom() + (iconBox.getHeight() - boundingBoxHeight * icy) * this.iconVerticalAdjustment;
app.saveState();
app.rectangle(iconBox.getLeft(), iconBox.getBottom(), iconBox.getWidth(), iconBox.getHeight());
app.clip();
app.newPath();
if (this.tp != null) {
app.addTemplate(this.tp, icx, 0, 0, icy, xpos, ypos);
} else {
float cox = 0;
float coy = 0;
if (matrix != null && matrix.size() == 6) {
PdfNumber nm = matrix.getAsNumber(4);
if (nm != null) {
cox = nm.floatValue();
}
nm = matrix.getAsNumber(5);
if (nm != null) {
coy = nm.floatValue();
}
}
app.addTemplateReference(this.iconReference, PdfName.FRM, icx, 0, 0, icy, xpos - cox * icx, ypos - coy * icy);
}
app.restoreState();
}
if (!Float.isNaN(textX)) {
app.saveState();
app.rectangle(offX, offX, box.getWidth() - 2 * offX, box.getHeight() - 2 * offX);
app.clip();
app.newPath();
if (this.textColor == null) {
app.resetGrayFill();
} else {
app.setColorFill(this.textColor);
}
app.beginText();
app.setFontAndSize(ufont, fsize);
app.setTextMatrix(textX, textY);
app.showText(this.text);
app.endText();
app.restoreState();
}
return app;
}
/**
* Gets the pushbutton field.
* @throws IOException on error
* @throws DocumentException on error
* @return the pushbutton field
*/
public PdfFormField getField() throws IOException, DocumentException {
final PdfFormField field = PdfFormField.createPushButton(this.writer);
field.setWidget(this.box, PdfAnnotation.HIGHLIGHT_INVERT);
if (this.fieldName != null) {
field.setFieldName(this.fieldName);
if ((this.options & READ_ONLY) != 0) {
field.setFieldFlags(PdfFormField.FF_READ_ONLY);
}
if ((this.options & REQUIRED) != 0) {
field.setFieldFlags(PdfFormField.FF_REQUIRED);
}
}
if (this.text != null) {
field.setMKNormalCaption(this.text);
}
if (this.rotation != 0) {
field.setMKRotation(this.rotation);
}
field.setBorderStyle(new PdfBorderDictionary(this.borderWidth, this.borderStyle, new PdfDashPattern(3)));
final PdfAppearance tpa = getAppearance();
field.setAppearance(PdfAnnotation.APPEARANCE_NORMAL, tpa);
final PdfAppearance da = (PdfAppearance)tpa.getDuplicate();
da.setFontAndSize(getRealFont(), this.fontSize);
if (this.textColor == null) {
da.setGrayFill(0);
} else {
da.setColorFill(this.textColor);
}
field.setDefaultAppearanceString(da);
if (this.borderColor != null) {
field.setMKBorderColor(this.borderColor);
}
if (this.backgroundColor != null) {
field.setMKBackgroundColor(this.backgroundColor);
}
switch (this.visibility) {
case HIDDEN:
field.setFlags(PdfAnnotation.FLAGS_PRINT | PdfAnnotation.FLAGS_HIDDEN);
break;
case VISIBLE_BUT_DOES_NOT_PRINT:
break;
case HIDDEN_BUT_PRINTABLE:
field.setFlags(PdfAnnotation.FLAGS_PRINT | PdfAnnotation.FLAGS_NOVIEW);
break;
default:
field.setFlags(PdfAnnotation.FLAGS_PRINT);
break;
}
if (this.tp != null) {
field.setMKNormalIcon(this.tp);
}
field.setMKTextPosition(this.layout - 1);
PdfName scale = PdfName.A;
if (this.scaleIcon == SCALE_ICON_IS_TOO_BIG) {
scale = PdfName.B;
} else if (this.scaleIcon == SCALE_ICON_IS_TOO_SMALL) {
scale = PdfName.S;
} else if (this.scaleIcon == SCALE_ICON_NEVER) {
scale = PdfName.N;
}
field.setMKIconFit(scale, this.proportionalIcon ? PdfName.P : PdfName.A, this.iconHorizontalAdjustment,
this.iconVerticalAdjustment, this.iconFitToBounds);
return field;
}
/**
* Getter for property iconFitToBounds.
* @return Value of property iconFitToBounds.
*/
public boolean isIconFitToBounds() {
return this.iconFitToBounds;
}
/**
* If true the icon will be scaled to fit fully within the bounds of the annotation,
* if false the border width will be taken into account. The default
* is false.
* @param iconFitToBounds if true the icon will be scaled to fit fully within the bounds of the annotation,
* if false the border width will be taken into account
*/
public void setIconFitToBounds(final boolean iconFitToBounds) {
this.iconFitToBounds = iconFitToBounds;
}
/**
* Holds value of property iconReference.
*/
private PRIndirectReference iconReference;
/**
* Gets the reference to an existing icon.
* @return the reference to an existing icon.
*/
public PRIndirectReference getIconReference() {
return this.iconReference;
}
/**
* Sets the reference to an existing icon.
* @param iconReference the reference to an existing icon
*/
public void setIconReference(final PRIndirectReference iconReference) {
this.iconReference = iconReference;
}
}