PDFsharp & MigraDoc Foundation

PDFsharp - A .NET library for processing PDF & MigraDoc Foundation - Creating documents on the fly
It is currently Sun Oct 17, 2021 7:38 pm

All times are UTC

Forum rules

Please read this before posting on this forum: Forum Rules

Post new topic Reply to topic  [ 4 posts ] 
Author Message
PostPosted: Fri Apr 26, 2019 11:20 am 

Joined: Fri Apr 26, 2019 11:15 am
Posts: 1

I'm just wondering if I can add accessibility tags to pdf with PDFSharp now. I found someone asked the same question years ago, and the answer was like this function was in the wish list then. Is it available now? If so, may you give me some tips, please?

Thx a lot

Reply with quote  
PostPosted: Sat Jan 23, 2021 2:01 am 

Joined: Sat Jan 09, 2021 7:09 am
Posts: 18
Here's a small example. This should get you started.

        static void Main(string[] args)
            string doc1 = @"C:\doc1.pdf";


            CSequence contents;

            using (var doc = PdfReader.Open(doc1, PdfDocumentOpenMode.Modify))




        public static void CreatePdf(string filename)
            // Create a new PDF document
            PdfDocument document = new PdfDocument();
            document.Info.Title = "Created with PDFsharp";

            // Create an empty page
            PdfPage page = document.AddPage();


            // Save the document...
            // ...and start a viewer.

        public static void AddTextToPage(PdfPage page)
            // Get an XGraphics object for drawing
            XGraphics gfx = XGraphics.FromPdfPage(page);

            // Create a font
            XFont font = new XFont("Verdana", 20, XFontStyle.BoldItalic, new XPdfFontOptions(PdfFontEncoding.WinAnsi));

            // Draw the text
            gfx.DrawString("Hello, World!", font, XBrushes.Black,
              new XRect(0, 0, page.Width, page.Height),

        // Please refer to the pdf tech specs on what all entails in the content stream
        // https://www.adobe.com/content/dam/acom/en/devnet/pdf/pdfs/PDF32000_2008.pdf
        public static void MakeAccessible(PdfDocument pdf)
            // if you don't have Adobe Acrobat to run accessibility check then
            // first download the Free Accessibility Checker (https://www.access-for-all.ch/en/pdf-accessibility-checker.html)
            // or open up an online accessibility checker in a browser

            // There are certain requirements the document has to meet
            // to make it near 100% compliant

            // Set you pdf version to PDF ver 1.7
            pdf.Version = 17;

            // Set the author of the document
            pdf.Info.Author = "Me, Myself, and I";

            // Date document was created
            pdf.Info.CreationDate = DateTime.Now;

            // The app/system that created the document
            pdf.Info.Creator = "My PDF Generator";

            // subject this document is about
            pdf.Info.Subject = "PDF Accessibility Test";

            #region /***** BEGIN ACCESSIBILITY REQUIREMENTS *****/

            pdf.Language = "en-US";
            pdf.Info.Title = "PDF Accessibiity";

            pdf.ViewerPreferences.DisplayDocTitle = true;
            pdf.ViewerPreferences.Direction = PdfReadingDirection.LeftToRight;

            // flag indicating the document conforms to Tagged PDF conventions
            PdfCatalog catalog = pdf.Internals.Catalog;
            PdfDictionary markInfo = new PdfDictionary(pdf);
            catalog.Elements.Add("/MarkInfo", markInfo);
            markInfo.Elements.Add("/Marked", PdfBoolean.True);

            // add outlines (bookmarks)
            // add root bookmark and set to first page as goto action
            pdf.Outlines.Add(pdf.Info.Title, pdf.Pages[0], true, PdfOutlineStyle.Bold);

            PdfArray parentRootTree = new PdfArray(pdf);

            List<PdfDictionary> tagList = new List<PdfDictionary>();

            // create tags for content elements within each page
            for (int i = 0; i < pdf.Pages.Count; i++)
                PdfPage page = pdf.Pages[i];

                // tag page as a structured parent object and assign a unique integer identifier
                page.Elements.Add("/StructParents", new PdfInteger(i));

                // specify a tab order.
                // The possible values are R(row order), C(column order),
                // and S (structure order)
                page.Elements.Add("/Tabs", new PdfName("/S"));

                // iterate thru each content item and assign a
                // marked content id and give it a structure type (Span, P, Table, TH, TR, etc.)
                PdfContents contents = page.Contents;
                if (contents != null && contents.Elements.Count > 0)
                    PdfArray elementRootNode = new PdfArray(pdf);

                    CSequence pageContents = ContentReader.ReadContent(page);
                    int numOfContentElements = pageContents.Count;

                    int mcid = 0; //starting marked content identifier
                    COperator currentElement = null;
                    COperator previousElement = null;
                    COperator nextElement = null;
                    CString newStringContent = null;
                    CSequence newContent = new CSequence();

                    // assign each content elements a MCID and put it into a
                    // marked content block
                    for (int j = 0; j < numOfContentElements; j++)
                        currentElement = (COperator)pageContents[j];

                        if (j > 0)
                            previousElement = (COperator)pageContents[j - 1];
                        if (j > 0 && j + 1 < numOfContentElements)
                            nextElement = (COperator)pageContents[j + 1];

                        // marked content if not already marked
                        if (currentElement.OpCode.OpCodeName == OpCodeName.q &&
                            (previousElement == null || previousElement.OpCode.OpCodeName != OpCodeName.BMC))

                            /*** BEGIN CONTENT STREAM CHANGES ***/
                            String elementStructureType = "/Span";

                            COperator beginDataContent = OpCodes.OperatorFromName("BDC");
                            newStringContent = new CString();
                            newStringContent.Value = $"{elementStructureType} ";
                            newStringContent.CStringType = CStringType.Dictionary;

                            newStringContent = new CString();
                            newStringContent.Value = $"<</MCID {mcid.ToString()}>> ";
                            newStringContent.CStringType = CStringType.Dictionary;

                            /*** END CONTENT STREAM CHANGES ***/

                            // add structure tags to page associating it to the marked content identifier
                            PdfDictionary structElement = new PdfDictionary(pdf);
                            structElement.Elements.Add("/K", new PdfInteger(mcid));
                            structElement.Elements.Add("/Pg", page.Reference.Value);
                            structElement.Elements.Add("/S", new PdfName("/P"));

                        else if (currentElement.OpCode.OpCodeName == OpCodeName.Q &&
                            (previousElement == null || nextElement.OpCode.OpCodeName != OpCodeName.EMC))
                            // add the closing tag of the marked content block
                            COperator endDataContent = OpCodes.OperatorFromName("EMC");
                            newStringContent = new CString();
                            newStringContent.Value = OpCodeName.q.ToString() + "\n";
                            newStringContent.CStringType = CStringType.Dictionary;




                    parentRootTree.Elements.Add(new PdfInteger(i));


            #region /*** BEGIN STRUCTURE TAGS ***/
            // the PdfStructureTreeRoot class is there in  https://github.com/empira/PDFsharp
            // however it's not available from PdfSharp in Nuget
            PdfDictionary structureRoot = new PdfDictionary(pdf);
            pdf.Internals.Catalog.Elements.Add("/StructTreeRoot", structureRoot);

            PdfDictionary docStructElement = new PdfDictionary(pdf);
            docStructElement.Elements.Add("/P", structureRoot.Reference);
            docStructElement.Elements.Add("/S", new PdfName("/Document"));

            PdfArray tagRefs = new PdfArray(pdf);
            foreach (var item in tagList)
                item.Elements.Add("/P", docStructElement.Reference.Value);
            docStructElement.Elements.Add("/K", tagRefs.Reference.Value);

            PdfArray docStructTreeArray = new PdfArray(pdf);

            PdfDictionary numDict = new PdfDictionary(pdf);
            numDict.Elements.Add("/Nums", parentRootTree.Reference.Value);

            structureRoot.Elements.Add("/K", docStructTreeArray);
            structureRoot.Elements.Add("/ParentTree", numDict.Reference);
            structureRoot.Elements.Add("/ParentTreeNextKey", new PdfInteger(parentRootTree.Count() + 1));
            structureRoot.Elements.Add("/Type", new PdfName("/StructTreeRoot"));

            #endregion /*** END STRUCTURE TAGS ***/

            #endregion /***** END ACCESSIBILITY REQUIREMENTS *****/



Reply with quote  
PostPosted: Wed Apr 21, 2021 9:19 am 

Joined: Wed Apr 21, 2021 8:07 am
Posts: 1
Dear rsoeung

Thanks for the MakeAccessible method. It got me started on the pdf/ua accessibility.

But it´s pretty hard to determine what tags I´m missing to add. I use PAC 3(https://www.access-for-all.ch/ch/pdf-werkstatt.html) to validate my PDF.

It shows it has 62 content errors that I try to fix. But the MakeAccessible method does not have an effect on the elements. Could you please guide me to how I fix the "Text object not tagged" and "Path object not tagged" ?

Pac 3 Status(Pac3.png)https://drive.google.com/file/d/1rjNMJwYdgVmEF0hXBK21NoapQHutwy_P/view?usp=sharing
PdfFromHtml.pdf: https://drive.google.com/file/d/1_OxJlgRiKeP7iIxmQFjQKcYdrZmziUol/view?usp=sharing

Reply with quote  
PostPosted: Sun Apr 25, 2021 12:20 pm 

Joined: Sat Jan 09, 2021 7:09 am
Posts: 18
Hi bandersenDK,

I use a simple tool called Pdf File Analyzer https://www.codeproject.com/Articles/450254/PDF-File-Analyzer-With-Csharp-Parsing-Classes-Vers to analyze the stream and contents of a pdf. The "Text object not tagged" and "Path object not tagged" errors refer to the contents stream within a "XObject" form. You'd have to modify the sample code to iterate through this content and add tags appropriately.


Reply with quote  
Display posts from previous:  Sort by  
Post new topic Reply to topic  [ 4 posts ] 

All times are UTC

Who is online

Users browsing this forum: No registered users and 18 guests

You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Jump to:  
Privacy Policy, Data Protection Declaration, Impressum
Powered by phpBB® Forum Software © phpBB Group