Deprecated API

Contents

• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Exceptions

Exceptions and Description
com.itextpdf.io.source.MapFailedException

Deprecated Fields

Field and Description
com.itextpdf.kernel.PdfException.AnnotShallHaveReferenceToPage
com.itextpdf.io.IOException.BadEndiannessTagNot0x4949Or0x4d4d
com.itextpdf.kernel.pdf.PdfName.BorderThikness
com.itextpdf.kernel.PdfException.CannotSetDataToPdfstreamWhichWasCreatedByInputstream
com.itextpdf.kernel.PdfException.CannotWritePdfStream
com.itextpdf.kernel.PdfException.CantDecodePkcs7SigneddataObject
com.itextpdf.kernel.PdfException.CantFindSigningCertificateWithSerial1
com.itextpdf.io.font.FontCache.CMAP_RESOURCE_PATH
com.itextpdf.kernel.PdfException.CodabarCharacterOneIsIllegal
com.itextpdf.kernel.PdfException.CodabarMustHaveAtLeastAStartAndStopCharacter
com.itextpdf.kernel.PdfException.CodabarStartStopCharacterAreOnlyExtremes
com.itextpdf.layout.border.Border.color use Border.transparentColor instead
com.itextpdf.layout.property.Underline.color
com.itextpdf.layout.property.Background.color
com.itextpdf.kernel.PdfException.ColorNotFound
com.itextpdf.kernel.PdfException.DictionaryNotContainFontData
com.itextpdf.io.IOException.DirectoryNumberTooLarge
com.itextpdf.barcodes.BarcodeDataMatrix.DM_X21 Use BarcodeDataMatrix.DM_X12 instead.
com.itextpdf.kernel.PdfException.DocumentClosedImpossibleExecuteAction
com.itextpdf.kernel.PdfException.DocumentHasNoCatalogObject
com.itextpdf.kernel.PdfException.DocumentMustBePreclosed
com.itextpdf.kernel.PdfException.DocumentToCopyToCannotBeNull
com.itextpdf.layout.layout.LayoutArea.emptyArea Will be removed in 7.1.0.
com.itextpdf.kernel.PdfException.ErrorReadingObjectStream
com.itextpdf.kernel.PdfException.FieldIsAlreadySigned
com.itextpdf.kernel.PdfException.FilePosition0CrossReferenceEntryInThisXrefSubsection
com.itextpdf.io.IOException.Font1IsNotRecognized
com.itextpdf.io.IOException.FontIsNotRecognized
com.itextpdf.kernel.PdfException.FontSizeTooSmall
com.itextpdf.io.IOException.ImageCanNotBeAnImageMask
com.itextpdf.io.IOException.ImageMaskIsNotAMaskDidYouDoMakeMask
com.itextpdf.kernel.pdf.PdfDocument.initialDocumentId
com.itextpdf.io.IOException.InvalidMagicValueForBmpFile
com.itextpdf.io.IOException.InvalidTTCFile
com.itextpdf.kernel.PdfException.IsNotAnAcceptableValueForTheField
com.itextpdf.kernel.PdfException.IsNotWmfImage
com.itextpdf.layout.element.Link.linkAnnotation
com.itextpdf.pdfa.checker.PdfAChecker.LOGGER Use slf4j logging instead.
com.itextpdf.io.IOException.MissingTagSForOjpegCompression
com.itextpdf.kernel.pdf.PdfDocument.modifiedDocumentId
com.itextpdf.kernel.PdfException.NameAlreadyExistsInTheNameTree
com.itextpdf.kernel.PdfException.PageWasAlreadyFlushed
com.itextpdf.kernel.PdfException.PageWasAlreadyFlushedUseAddFieldAppearanceToPageMethodBeforePageFlushing
com.itextpdf.io.IOException.PdfEncodings because naming clash with PdfEncodings may produce confusion with imports Superseded by IOException.CharacterCodeException
com.itextpdf.kernel.PdfException.PdfInderectObjectBelongToOtherPdfDocument Will be removed in iText 7.1.0. There is a typo in the name of the constant. Use PdfException.PdfIndirectObjectBelongsToOtherPdfDocument instead.
com.itextpdf.kernel.PdfException.PdfPageShallHaveContent
com.itextpdf.io.IOException.PngFilterUnknown
com.itextpdf.io.IOException.PrematureEofWhileReadingJpg
com.itextpdf.layout.RootElement.properties This field just hides the same field from ElementPropertyContainer
com.itextpdf.io.font.CidFontProperties.RESOURCE_PATH_CMAP
com.itextpdf.layout.property.Property.REVERSED
com.itextpdf.io.font.FontConstants.STRIKETHRU
com.itextpdf.io.IOException.TheCmap1WasNotFound
com.itextpdf.kernel.PdfException.TheNumberOfBooleansInTheArrayDoesntCorrespondWithTheNumberOfFields
com.itextpdf.kernel.PdfException.ThisInstanceOfPdfSignerIsAlreadyClosed
com.itextpdf.io.IOException.TTCIndexDoesNotExistInFile
com.itextpdf.io.font.FontConstants.UNDERLINE
com.itextpdf.kernel.PdfException.UnknownColorFormatMustBeRGBorRRGGBB
com.itextpdf.io.IOException.WrongNumberOfComponentsInIccProfile
com.itextpdf.kernel.PdfException.YouCannotFlushPdfCatalogManually

Deprecated Methods

Method and Description
com.itextpdf.kernel.pdf.canvas.parser.clipper.ClipperBridge.addContour(Path, List, Boolean) close will be boolean. Visibility will be changed to internal.
com.itextpdf.kernel.pdf.PdfResources.addExtGState(PdfObject) Will be removed in iText 7.1. Use more safe PdfResources.addExtGState(PdfDictionary) instead.
com.itextpdf.kernel.pdf.PdfResources.addForm(PdfObject) Will be removed in iText 7.1. Use more safe PdfResources.addForm(PdfStream) instead.
com.itextpdf.kernel.pdf.PdfResources.addImage(PdfObject) Will be removed in iText 7.1. Use more safe PdfResources.addImage(PdfStream) instead.
com.itextpdf.kernel.pdf.PdfResources.addPattern(PdfObject) Will be removed in iText 7.1. Use more safe PdfResources.addPattern(PdfDictionary) instead.
com.itextpdf.kernel.pdf.PdfResources.addProperties(PdfObject) Will be removed in iText 7.1. Use more safe PdfResources.addProperties(PdfDictionary) instead.
com.itextpdf.kernel.pdf.PdfResources.addShading(PdfObject) Will be removed in iText 7.1. Use more safe PdfResources.addShading(PdfDictionary) instead.
com.itextpdf.layout.renderer.AbstractRenderer.alignChildHorizontally(IRenderer, float)
com.itextpdf.layout.renderer.AccessibleAttributesApplier.applyLayoutAttributes(PdfName, AbstractRenderer, PdfDocument) Will be removed in iText 7.1
com.itextpdf.layout.renderer.AccessibleAttributesApplier.applyListAttributes(AbstractRenderer) Will be removed in iText 7.1
com.itextpdf.layout.renderer.BlockRenderer.applyRotation() Will be removed in iText 7.1
com.itextpdf.layout.renderer.AccessibleAttributesApplier.applyTableAttributes(AbstractRenderer) Will be removed in iText 7.1
com.itextpdf.kernel.pdf.PdfWriter.calculateIndRefKey(PdfIndirectReference)
com.itextpdf.layout.renderer.TableRenderer.calculateScaledColumnWidths(Table, float) Method will be removed in 7.1.
com.itextpdf.layout.element.Table.calculateWidths() This method does nothing after implementation table column width algorithms.
com.itextpdf.kernel.font.PdfFontFactory.checkFontDictionary(PdfDictionary, PdfName, boolean) this method will become private in 7.1. Do not use this method
com.itextpdf.kernel.font.PdfFont.checkTrueTypeFontDictionary(PdfDictionary) Will be removed in 7.1
com.itextpdf.kernel.font.PdfFont.checkTrueTypeFontDictionary(PdfDictionary, boolean) Will be removed in 7.1
com.itextpdf.kernel.font.PdfFont.containsGlyph(char) Use PdfFont.containsGlyph(int) instead.
com.itextpdf.layout.renderer.BlockRenderer.correctPositionedLayout(Rectangle)
com.itextpdf.forms.fields.PdfFormField.createChoice(PdfDocument, Rectangle, String, String, PdfFont, int, PdfArray, int) Will be removed in 7.1. Use PdfFormField.createChoice(PdfDocument, Rectangle, String, String, PdfFont, float, PdfArray, int) instead
com.itextpdf.io.font.FontProgramFactory.createFont(String, byte[], boolean) Use FontProgramFactory.createFont(byte[], boolean) or FontProgramFactory.createFont(String, boolean)
com.itextpdf.forms.fields.PdfFormField.createMultilineText(PdfDocument, Rectangle, String, String, PdfFont, int) use PdfFormField.createMultilineText(PdfDocument, Rectangle, String, String, PdfFont, float) instead
com.itextpdf.layout.renderer.ParagraphRenderer.createOverflowRenderer()
com.itextpdf.kernel.pdf.xobject.PdfImageXObject.createPdfStream(ImageData, PdfImageXObject)
com.itextpdf.forms.fields.PdfFormField.createPushButton(PdfDocument, Rectangle, String, String, PdfFont, int) Will be removed in 7.1. Use PdfFormField.createPushButton(PdfDocument, Rectangle, String, String, PdfFont, float) instead.
com.itextpdf.layout.renderer.ParagraphRenderer.createSplitRenderer()
com.itextpdf.forms.fields.PdfFormField.createText(PdfDocument, Rectangle, String, String, PdfFont, int) Will be removed in 7.1. Use PdfFormField.createText(PdfDocument, Rectangle, String, String, PdfFont, float) instead.
com.itextpdf.forms.fields.PdfFormField.createText(PdfDocument, Rectangle, String, String, PdfFont, int, boolean) Will be removed in 7.1. Use PdfFormField.createText(PdfDocument, Rectangle, String, String, PdfFont, float, boolean) instead.
com.itextpdf.io.font.FontProgramFactory.createType1Font(String, byte[], byte[], boolean) Use FontProgramFactory.createType1Font(byte[], byte[]) or FontProgramFactory.createType1Font(String, String) instead
com.itextpdf.kernel.pdf.PdfString.decrypt(PdfEncryption) use PdfString.decodeContent() or PdfString.getValue() methods, they will decrypt bytes if they are encrypted. Will be removed in iText 7.1
com.itextpdf.kernel.pdf.PdfDictionary.directEntrySet() Use PdfDictionary.entrySet() instead.
com.itextpdf.kernel.pdf.PdfArray.directIterator() Use PdfArray.iterator() instead.
com.itextpdf.kernel.pdf.PdfDictionary.directValues() Use PdfDictionary.values() instead.
com.itextpdf.layout.border.Border.draw(PdfCanvas, float, float, float, float, float, float) Will be removed in 7.1.0. use Border.draw(PdfCanvas, float, float, float, float, Side, float, float) instead
com.itextpdf.layout.renderer.TableRenderer.drawBorders(DrawContext, boolean, boolean)
com.itextpdf.forms.fields.PdfFormField.drawButton(PdfCanvas, float, float, float, float, String, PdfFont, int) Will be removed in 7.1. Use PdfFormField.drawButton(PdfCanvas, float, float, float, float, String, PdfFont, float) instead.
com.itextpdf.forms.fields.PdfFormField.drawCheckBox(PdfCanvas, float, float, int, boolean) Will be removed in 7.1. Use PdfFormField.drawCheckBox(PdfCanvas, float, float, float, boolean) instead.
com.itextpdf.forms.fields.PdfFormField.drawMultiLineTextAppearance(Rectangle, PdfFont, int, String, PdfFormXObject) Will be removed in 7.1. Use PdfFormField.drawMultiLineTextAppearance(Rectangle, PdfFont, float, String, PdfFormXObject) instead.
com.itextpdf.forms.fields.PdfFormField.drawPushButtonAppearance(float, float, String, PdfFont, int) Will be removed in 7.1. Use PdfFormField.drawPushButtonAppearance(float, float, String, PdfFont, float) instead.
com.itextpdf.layout.renderer.TextRenderer.drawSingleUnderline(Underline, Color, PdfCanvas, float, float)
com.itextpdf.forms.fields.PdfFormField.drawTextAppearance(Rectangle, PdfFont, int, String, PdfFormXObject) Will be removed in 7.1. Use PdfFormField.drawTextAppearance(Rectangle, PdfFont, float, String, PdfFormXObject) instead.
com.itextpdf.forms.fields.PdfFormField.generateDefaultAppearanceString(PdfFont, int, PdfResources) Will be removed in 7.1. Use PdfFormField.generateDefaultAppearanceString(PdfFont, float, Color, PdfResources) instead.
com.itextpdf.io.font.FontCache.getAllFonts() Use FontCache.getAllPredefinedCidFonts() instead.
com.itextpdf.kernel.utils.PageRange.getAllPages() Please use PageRange.getQualifyingPageNums(int)
com.itextpdf.layout.border.Border.getBorderSide(float, float, float, float) Will be removed in 7.1.0. use Border.getBorderSide(float, float, float, float, Side) instead
com.itextpdf.kernel.geom.LineSegment.getBoundingRectange() Use getBoundingRectangle(). Will be removed in 7.1
com.itextpdf.kernel.pdf.PdfWriter.getCopyObjectKey(PdfObject) Functionality will be removed.
com.itextpdf.io.util.FileUtil.getFileName(String)
com.itextpdf.layout.font.FontInfo.getFontProgram() use FontInfo.getFontData() instead.
com.itextpdf.kernel.pdf.extgstate.PdfExtGState.getHTP()
com.itextpdf.kernel.pdf.PdfCatalog.getLang(PdfName)
com.itextpdf.kernel.pdf.annot.PdfLineAnnotation.getLeaderLine() use PdfLineAnnotation.getLeaderLineLength() instead.
com.itextpdf.layout.font.FontInfo.getPdfFont(FontProvider) use FontProvider.getPdfFont(FontInfo) instead.
com.itextpdf.layout.layout.LayoutArea.isEmptyArea() Will be removed in 7.1.0.
com.itextpdf.layout.renderer.TextRenderer.isNewLine(GlyphLine, int) Use TextUtil.isNewLine(Glyph) instead.
com.itextpdf.kernel.pdf.annot.PdfAnnotation.makeAnnotation(PdfObject, PdfAnnotation) This method will be removed in iText 7.1. Please, simply use PdfAnnotation.makeAnnotation(PdfObject).
com.itextpdf.kernel.pdf.navigation.PdfStringDestination.replaceNamedDestination(Map) do not use this method. Will be removed in 7.1
com.itextpdf.kernel.pdf.navigation.PdfNamedDestination.replaceNamedDestination(Map) do not use this method. Will be removed in 7.1
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.replaceNamedDestination(Map) do not use this method. Will be removed in 7.1
com.itextpdf.kernel.pdf.navigation.PdfDestination.replaceNamedDestination(Map) do not use this method. Will be removed in 7.1
com.itextpdf.kernel.pdf.PdfResources.setDefaultColorSpace(PdfName, PdfColorSpace) Will be removed in iText 7.1.0. Use PdfResources.setDefaultGray(PdfColorSpace), PdfResources.setDefaultRgb(PdfColorSpace) or PdfResources.setDefaultCmyk(PdfColorSpace) instead.
com.itextpdf.layout.layout.LayoutArea.setEmptyArea(boolean) Will be removed in 7.1.0.
com.itextpdf.kernel.pdf.PdfString.setEncoding(String) Create a new instance with PdfString.PdfString(String, String) instead.
com.itextpdf.kernel.pdf.extgstate.PdfExtGState.setHTP(PdfObject)
com.itextpdf.kernel.pdf.PdfDocument.setInitialDocumentId(PdfString) Will be removed in 7.1. Use WriterProperties.setInitialDocumentId(PdfString) instead
com.itextpdf.kernel.pdf.annot.PdfLineAnnotation.setLeaderLine(float) use PdfLineAnnotation.setLeaderLineLength(float) instead.
com.itextpdf.kernel.pdf.extgstate.PdfExtGState.setLineCapStryle(int) Use PdfExtGState.setLineCapStyle(int) instead.
com.itextpdf.kernel.pdf.PdfDocument.setModifiedDocumentId(PdfString) Will be removed in 7.1. Use WriterProperties.setModifiedDocumentId(PdfString) instead
com.itextpdf.kernel.xmp.XmlDomWriter.setOutput(Writer) Try to use XmlDomWriter.setOutput(java.io.OutputStream, String) instead
com.itextpdf.forms.fields.PdfFormField.setValue(String, PdfFont, int) Use PdfFormField.setValue(String, PdfFont, float) instead
com.itextpdf.kernel.font.PdfFont.splitString(String, int, float) Will be removed in 7.1. Use PdfFont.splitString(String, float, float) instead
com.itextpdf.layout.renderer.TextRenderer.trimLast() visibility will be changed to package.
com.itextpdf.signatures.OCSPVerifier.verifyResponse(BasicOCSPResp, X509Certificate)
com.itextpdf.kernel.font.PdfFont.writeText(GlyphLine, PdfOutputStream)

Deprecated Constructors

Constructor and Description
com.itextpdf.kernel.pdf.colorspace.PdfShading.Axial(PdfDictionary) Intended only for private use. You should use PdfShading.makeShading(PdfDictionary) instead.
com.itextpdf.kernel.pdf.colorspace.PdfShading.CoonsPatchMesh(PdfStream) Intended only for private use. You should use PdfShading.makeShading(PdfDictionary) instead.
com.itextpdf.kernel.pdf.colorspace.PdfShading.FreeFormGouraudShadedTriangleMesh(PdfStream) Intended only for private use. You should use PdfShading.makeShading(PdfDictionary) instead.
com.itextpdf.kernel.pdf.colorspace.PdfShading.FunctionBased(PdfDictionary) Intended only for private use. You should use PdfShading.makeShading(PdfDictionary) instead.
com.itextpdf.kernel.pdf.colorspace.PdfShading.LatticeFormGouraudShadedTriangleMesh(PdfStream) Intended only for private use. You should use PdfShading.makeShading(PdfDictionary) instead.
com.itextpdf.io.font.otf.OtfClass(RandomAccessFileOrArray, int) use OtfClass.create(RandomAccessFileOrArray, int) instead.
com.itextpdf.kernel.pdf.PdfOutline(PdfDocument) Use PdfCatalog.getOutlines(boolean) instead.
com.itextpdf.kernel.pdf.PdfOutline(String, PdfDictionary, PdfDocument) Use PdfCatalog.getOutlines(boolean) instead.
com.itextpdf.kernel.pdf.PdfOutline(String, PdfDictionary, PdfOutline) Use PdfCatalog.getNextItem(PdfDictionary, PdfOutline, Map), PdfOutline.addOutline(String, int) and PdfOutline.addOutline(String) instead.
com.itextpdf.kernel.pdf.colorspace.PdfShading(PdfDictionary, int, PdfObject) Use PdfShading.PdfShading(PdfDictionary, int, PdfColorSpace) instead.
com.itextpdf.kernel.pdf.xobject.PdfXObject()
com.itextpdf.kernel.pdf.xobject.PdfXObject(PdfStream)
com.itextpdf.kernel.pdf.colorspace.PdfShading.Radial(PdfDictionary) Intended only for private use. You should use PdfShading.makeShading(PdfDictionary) instead.
com.itextpdf.layout.element.Table(int) in 7.1 each column will have undefined width. Use another constructor to get predictable result.
com.itextpdf.layout.element.Table(int, boolean) in 7.1 each column will have undefined width. Use another constructor to get predictable result.
com.itextpdf.kernel.pdf.colorspace.PdfShading.TensorProductPatchMesh(PdfStream) Intended only for private use. You should use PdfShading.makeShading(PdfDictionary) instead.
com.itextpdf.io.font.TrueTypeCollection(byte[], String) Will be removed in 7.1. Use TrueTypeCollection.TrueTypeCollection(byte[]) instead
com.itextpdf.io.font.TrueTypeCollection(String, String) Will be removed in 7.1. Use TrueTypeCollection.TrueTypeCollection(String) instead