Merge pull request #487 from telerik/new-kb-radpdfprocessing-customize-textboxfield-colors-8b6d282f9000452594abd22c900a4667

Added new kb article radpdfprocessing-customize-textboxfield-colors

Author: dessyordanova

knowledge-base/images/highlight-textbox-field.gif

@@ -0,0 +1,77 @@
+---
+title: Customizing Text and Border Colors to Highlight a TextBoxField with RadPdfProcessing
+description: Learn how to alter the text and border colors to highlight a TextBoxField within a PDF document using RadPdfProcessing.
+type: how-to
+page_title: How to Change Text and Border Colors to Highlight a TextBoxField with RadPdfProcessing
+slug: radpdfprocessing-customize-textboxfield-colors
+tags: pdfprocessing, document, processing, textbox, field, color, border, customization, pdf, highlight 
+res_type: kb
+ticketid: 1673638
+---
+
+## Environment
+
+| Version | Product | Author | 
+| --- | --- | ---- | 
+| 2024.4.1106| RadPdfProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| 
+
+## Description
+
+When creating PDF documents containing [form fields]({%slug radpdfprocessing-model-interactive-forms-form-fields%}), you might need to update the text and border colors of a [TextBoxField]({%slug radpdfprocessing-model-interactive-forms-form-fields-textboxfield%}) and highlight specific fields. This article demonstrates how to customize the appearance of `TextBoxField` elements, including changing their text and border colors.
+
+![Highlight TextBox Field](images/highlight-textbox-field.gif)    
+
+## Solution
+
+To change the text and border colors of a `TextBoxField` in a PDF document, utilize the `TextProperties` and `AppearanceCharacteristics` properties provided by the [VariableContentWidget]({%slug radpdfprocessing-model-annotations-widgets%}) class. The following example demonstrates how to customize these aspects.
+
+1. Create a new [RadFixedDocument]({%slug radpdfprocessing-model-radfixeddocument%}) and add a page to it.
+2. Instantiate a `TextBoxField` and configure its properties as needed.
+3. Add a widget to the `TextBoxField` and set up the text and border colors using the `TextProperties` and [AppearanceCharacteristics]({%slug radpdfprocessing-model-interactive-forms-dynamic-appearance-properties%}) properties.
+4. Recalculate the content of the widget and add the `TextBoxField` to the document.
+5. Save the document to a file.
+
+```csharp
+RadFixedDocument fixedDocument = new RadFixedDocument();
+fixedDocument.Pages.AddPage();
+
+TextBoxField textField = new TextBoxField("SampleTextBox")
+{
+    MaxLengthOfInputCharacters = 500,
+    IsMultiline = true,
+    IsPassword = false,
+    IsFileSelect = false,
+    ShouldSpellCheck = true,
+    AllowScroll = true,
+    Value = "Sample content",
+};
+
+VariableContentWidget widget = textField.Widgets.AddWidget();
+VariableTextProperties textProperties = new VariableTextProperties();
+textProperties.Fill = new RgbColor(255, 0, 0); // Set text color to red
+textProperties.FontSize = 24; 
+widget.TextProperties = textProperties;
+
+widget.AppearanceCharacteristics.BorderColor = new RgbColor(0, 0, 0); // Set border color to black
+widget.AppearanceCharacteristics.Background = new RgbColor(255, 255, 0); // Optional: Set background color to yellow
+widget.Rect = new Rect(10, 10, 250, 50);
+widget.RecalculateContent();
+
+fixedDocument.AcroForm.FormFields.Add(textField);
+fixedDocument.Pages[0].Annotations.Add(widget);
+
+string fileName = "CustomizedTextBoxField.pdf";
+File.WriteAllBytes(fileName, new PdfFormatProvider().Export(fixedDocument, TimeSpan.FromSeconds(10)));
+
+Console.WriteLine("Document with customized TextBoxField created.");
+```
+
+The demonstrated approach is applicable not only for creating new documents, but for importing documents that already contains form fields as well. 
+
+## See Also
+
+- [TextBoxField Documentation]({%slug radpdfprocessing-model-interactive-forms-form-fields-textboxfield%})
+- [Text and Graphic Properties]({%slug radpdfprocessing-editing-text-and-graphic-properties%})
+- [Create Interactive Forms SDK Example](https://github.com/telerik/document-processing-sdk/tree/master/PdfProcessing/CreateInteractiveForms)
+- [Modify Form Values SDK Example](https://github.com/telerik/document-processing-sdk/tree/master/PdfProcessing/ModifyForms)
+

knowledge-base/radpdfprocessing-customize-textboxfield-colors.md

@@ -90,3 +90,4 @@ TextBoxField exposes the following properties:
 * [CombTextBoxField Class]({%slug radpdfprocessing-model-interactive-forms-form-fields-combtextboxfield%})
 * [Create Interactive Forms SDK example](https://github.com/telerik/document-processing-sdk/tree/master/PdfProcessing/CreateInteractiveForms) 
 * [Modifying Forms SDK example](https://github.com/telerik/document-processing-sdk/tree/master/PdfProcessing/ModifyForms) 
+* [Customizing Text and Border Colors to Highlight a TextBoxField with RadPdfProcessing]({%slug radpdfprocessing-customize-textboxfield-colors%})