Color in a valid format (like #FF8800 for orange) or from the predefined set (like Colors.Red.Lighten1). The text key corresponding to the value used when defining the Section element. The URL of the webpage to which the user will be redirected. Although this adjustment modifies the space available to its inner content, some elements might use their own strategies to fill that space. For example, an Image with the setting may retain its size, but its quality could vary based on the DPI setting. In contrast, text will not only appear smaller or bigger; but also a different number of words may fit each line. The scaling factor. Values greater than one enlarge the content, while values less than one reduce it. Please note that there is a significant difference between image resolution (number of pixels vertically and horizontally) and its physical size described in points. Therefore, the resolution of an image is not used for determining its physical size on the document. Multiple strategies exist for the Image element to determine its final size. By default, the image fills all the available width. This behavior can be customized using options within the descriptor class. Images are automatically resized and compressed based on the descriptor's setup. It defaults to global document's settings. Supported formats: PNG, JPEG and WEBP. When enabled, the library does not resize the image to achieve the target DPI, nor compress it with target image quality. Specifies the DPI (dots-per-inch) for rasterizing images, which is a measure of an image's resolution that indicates how many individual dots (or pixels) fit into one inch of a printed image. Higher DPI values result in greater detail and sharpness, making images appear clearer when printed, while lower DPI values can cause images to look blurry or pixelated. The target resolution is computed by multiplying the DPI with the physical image size on the document. Default DPI value is 288 DPI. If the image has lower resolution that the one calculated from the DPI setting, it will NOT be rescaled. Consider an image of dimensions 3x4 inches. Using a DPI value of 300, the final resolution translates to 900x1200 pixels. Controls the balance between an image's file size and its visual fidelity during compression. Higher quality values preserve more detail with larger file sizes, while lower values reduce file size at the cost of potential image degradation, such as blurriness or artifacts. Opaque images are JPEG-encoded based on this setting, while images with an alpha channel default to PNG format, disregarding this option. Default is set to "high quality". Descriptor allowing adjustments to image attributes, such as scaling behavior, compression quality, and target DPI. Multiple strategies exist for the Image element to determine its final size. By default, the image fills all the available width. This behavior can be customized using options within the descriptor class. Descriptor allowing adjustments to the SVG image scaling behavior. This writing system is used by most of modern languages. The content direction affects various layout structures. In LTR mode, items are typically aligned to the left. This mode also influences the direction of items in certain layouts. For instance, in a row element with LTR mode, the first item is positioned on the left, while the last item is on the right. This writing system is used by languages such as Hebrew, Arabic, and Persian. The content direction affects various layout structures. In RTL mode, items are typically aligned to the right. This mode also influences the direction of items in certain layouts. For instance, in a row element with RTL mode, the first item is positioned on the right, while the last item is on the left. Handler for adjusting the appearance of the text span, including attributes like color, size, and background. Handler for adjusting the appearance of the text span, including attributes like color, size, and background. Additionally, it provides formatting options, like displaying the page number in custom text format (e.g. Roman numerals). Limits the number of visible lines in a paragraph, truncating overflow text with an ellipsis or by hiding it to maintain layout consistency. Aligns text horizontally to the left side. Aligns text horizontally to the center, ensuring equal space on both left and right sides. Aligns content horizontally to the right side. Aligns the text horizontally to the start of the container. This method sets the horizontal alignment of the text to the start (left for left-to-right languages, right for right-to-left languages). Aligns the text horizontally to the end of the container. This method sets the horizontal alignment of the text to the end (right for left-to-right languages, left for right-to-left languages). Justifies the text within its container. This method sets the horizontal alignment of the text to be justified, meaning it aligns along both the left and right margins. This is achieved by adjusting the spacing between words and characters as necessary so that each line of text stretches from one end of the text column to the other. This creates a clean, block-like appearance for the text. Sets the font color. The font color determines the color applied to text characters, affecting their visual appearance. It also influences the default color of text decorations, such as underlines. Sets a solid background color for the text. This color fills the area behind the text or other elements, enhancing contrast and providing visual emphasis. Sets the font family of the text. A font family is a collection of related fonts that share a consistent design style but may vary in weight, style, or width. Examples of font families include Arial, Times New Roman, and Calibri. By default, the library searches all fonts available in the runtime environment. This may work well on the development environment but may fail in the cloud where fonts are usually not installed. It is safest deploy font files along with the application and then register them using the FontManager class. Actual font family (e.g. "Times New Roman", "Calibri", "Lato") or custom identifier used when invoking the FontManager method. Enables or disables font features defined by the OpenType standard, e.g. kernig, ligatures. Font features are always encoded as 4-character long strings. For example, the ligatures feature is encode as liga, while the kernig feature as kern. For a list of available features, refer to the FontFeatures class. To better understand what font features are, please consider example definitions. Please note that there are many more various font features. Most fonts support only a handful of them, having some of them enabled by default: Ligatures in typography are specific character combinations that are designed to improve the aesthetics and readability of certain letter pairs. For example, in some fonts, when you type certain combinations of letters like 'fi' or 'fl', they will be replaced with a single, joined glyph. Kerning in typography refers to the adjustment of space between characters in a proportional font. It's used to achieve a visually pleasing result by adjusting the spacing of specific character pairs. For example, in many fonts, the pair 'AV' is kerned so that the 'A' and 'V' are closer together than they would be by default. TextStyle.Default.EnableFontFeature(FontFeatures.StandardLigatures); TextStyle.Default.DisableFontFeature(FontFeatures.Kerning); Provide font feature name or use the FontFeatures class. Sets font size for the text. Font size measures the height of text characters, determining how large or small the text appears. It's worth noting that different fonts may render text with distinct visual sizes, even when assigned the same numerical font size. Allows text to wrap at any character, not just spaces. Adjusts the vertical spacing between lines of text, affecting readability and overall text layout. The added space is proportional to the text size. A value of 1 retains the original spacing. Learn more Sets the proportion of vertical spacing relative to the font size. A value greater than 1 increases the spacing, while a value less than 1 decreases it. The value must be greater than 0. A value of 1 sets the line height equal to the font size. This setting may result in insufficient vertical spacing around the text. A value of default indicates that the font metrics should be used to calculate the line spacing, which is the default behavior. Adjusts the horizontal spacing between characters in the text, affecting readability and overall visual style. The adjustment is proportional to the text size. Learn more Sets the proportion by which the horizontal space between characters is changed. A value of 0 maintains the original spacing. When the value is positive, the text is more spread out. When it is negative, the text is more condensed. Adjusts the horizontal spacing between words in the text, affecting readability and overall visual style. The adjustment is proportional to the text size. Sets the proportion by which the horizontal space between words is changed. A value of 0 maintains the original spacing. When the value is positive, the text is more spread out. When it is negative, the text is more condensed. Adjusts the vertical gap between successive paragraphs (separated by line breaks), helping to visually separate blocks of text for improved readability. Specifies the horizontal offset of the first line in a paragraph. Commonly used to visually separate paragraphs in a block of text. Renders text with an italic effect, where letters are slightly slanted to the right. Commonly used for emphasis or to distinguish specific words. Draws a line through the middle of the text. Draws a line under the text. Draws a line above the text. You can control the decoration visuals by setting color and style (solid, double, wavy, dotted, dashed) of the line. Applies for the following text decorations: striketrough, underline, overline. Sets the color of the text decoration. Changess thickness of decoration line proportionally to the provided argument. Value equal to 1 is the default thickness. Sets the decoration line to a solid straight line. Sets the decoration line to a solid double line. Sets the decoration line to wave. Sets the decoration line to dots. Sets the decoration line to dashes. Sets the font weight to "thin" (equivalent to CSS 100). Learn more Sets the font weight to "extra light" (equivalent to CSS 200). Learn more Sets the font weight to "light" (equivalent to CSS 300). Learn more Sets the font weight to "normal" or "regular (equivalent to CSS 400). Learn more Sets the font weight to "medium" (equivalent to CSS 500). Learn more Sets the font weight to "semi bold" (equivalent to CSS 600). Learn more Sets the font weight to "bold" (equivalent to CSS 700). Learn more Sets the font weight to "extra bold" (equivalent to CSS 800). Learn more Sets the font weight to "black" (equivalent to CSS 900). Learn more Sets the font weight to "extra black" (equivalent to CSS 1000). Learn more Determines the thickness of the text characters, ranging from light to bold, to create visual hierarchy or emphasis. Not all fonts support every weight. If the specified weight isn't available, the library selects the closest available option. Resets the text position and size to default, utilizing the full available line height. Learn more Sets the text style to subscript, making it smaller and positioning it below the baseline, e.g.: H₂0. Learn more Sets the text style to subscript, making it smaller and positioning it above the baseline, e.g.: y² + x² = 1. Learn more Resets the text direction, enabling content to follow the automatically detected direction. Enforces a left-to-right text direction. Enforces a right-to-left text direction. Sets a font style using the typography pattern. Learn more This API reduces the garbage collector pressure and offers the best performance. Connects to the QuestPDF Companion application to automatically preview the document being currently implemented after every code modification, without the need to recompile the code or restart the application. Learn more For details on the hot-reload functionality, please refer to the documentation of your preferred IDE. Specifies port for communication with the QuestPDF Previewer application. Default value is 12500. The hot-reload feature and QuestPDF Companion integration are available only in the .NET 6 environment or later. Please consider updating your project. Installation and usage
Features overview This parameter is ignored. Components serve as modular building blocks for abstracting document layouts. They promote code reusability across multiple sections or types of documents. Using a component, you can generate content based on its internal state. Learn more Consider the scenario of a company-wide page header. Instead of replicating the same header design across various documents, a single component can be created and referenced wherever needed. Syntax Description 1, 2, 3 Plain numbers indicate pages numbered from the start r1, r2 Numbers with 'r' prefix count from the end (r1 = last page) z Represents the last page (equivalent to r1) 1-5 Dash-separated ranges are inclusive 5-1 Reversed ranges list pages in descending order x1-3 Excludes specified pages from previous range :odd Selects odd-positioned pages from the resulting page-set :even Selects even-positioned pages from the resulting page-set Expression Result 1,6,4 pages 1, 6, and 4 in that order 3-7 pages 3 through 7 inclusive 7-3 pages 7, 6, 5, 4, and 3 in that order 1-z all pages in order z-1 all pages in reverse order r3-r1 the last three pages of the document r1-r3 the last three pages of the document in reverse order 1-20:even even pages from 2 to 20 5,7-9,12 pages 5, 7, 8, 9, and 12 5,7-9,12:odd pages 5, 8, and 12 (pages in odd positions from the original set of 5, 7, 8, 9, 12) 5,7-9,12:even pages 7 and 9 (pages in even positions from the original set of 5, 7, 8, 9, 12) 1-10,x3-4 pages 1 through 10 except pages 3 and 4 (1, 2, and 5 through 10) 4-10,x7-9,12-8,xr5 In a 15-page file: pages 4, 5, 6, 10, 12, 10, 9, and 8 in that order (pages 4 through 10 except 7 through 9, followed by 12 through 8 descending, except 11 which is the fifth page from the end) Specifies whether the user is permitted to add signatures and annotations to the document. Specifies whether the user is allowed to copy text and graphics from the document. Specifies whether the user is permitted to insert, rotate, or delete pages within the document. Specifies whether the user can print the document. Specifies whether the user is permitted to insert, rotate, or delete pages within the document. Specifies whether the user is allowed to fill out existing form fields in the document. Determines whether the document's metadata is included in encryption.