Improve WordTextBox functionality #197
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Updated WordTextBox constructors and methods to support an enumerated type for text wrapping options, replacing the boolean flag. Introduced WrapTextImage? property and adjusted internal behavior to use new text wrapping representation, enhancing the flexibility and readability of text wrapping logic in TextBox elements. Removed obsolete code paths that previously handled the boolean wrap logic.
Rework the handling of image wrapping in Word documents by removing the ineffective WrapTextImage enum handlers and consolidating the wrap logic within WordWrapTextImage utility class. This change streamlines the wrapping functionality, improves maintainability, and prepares for future extension. Removed redundant code blocks and corrected typo for WrapTextImage.InFrontOfText. The updated utility class now provides clearer abstraction and better separation of concerns, paving the way for implementing wrap setting functionality.
Updated the AddTextBox method to accept WrapTextImage enum, replacing the less descriptive boolean parameter for text wrapping. This change enables more robust text wrapping options and improves readability by explicitly stating the wrapping style in the method signature.
Introduced an optional parameter to specify the text wrapping style when adding text boxes. Default wrap style set to 'Square' to maintain backward compatibility and enhance layout flexibility without breaking existing implementations.
Fixed a typo in the enumeration used to specify image wrapping style in the document, changing `WrapTextImage.InFrontText` to the correct `WrapTextImage.InFrontOfText`. This ensures that images wrap as intended when placed over text.
Corrected the enum value for image text wrapping from `InFrontText` to `InFrontOfText`, ensuring consistency across image wrapping functionality tests and method calls. This change aligns the code with the correct terminology, improving code clarity and preventing potential misinterpretations that could arise from using an inaccurate enum value.
- Updated the AddParagraphAfterSelf method to accept an optional parameter, allowing reuse of an existing paragraph for appending, thereby enhancing flexibility when manipulating document structures. - Introduced a new overload for AddParagraph in WordSection, enabling creation with a designated run flag for finer control over paragraph styling and rendering. - Included a new method for adding textboxes with specified text and wrapping style to enrich content formatting capabilities within document sections. - Adjusted AddHorizontalLine and AddHyperLink methods to explicitly pass an empty string to AddParagraph, ensuring consistent method behavior. These changes collectively improve the document modification API, offering users more control and ease when adding and customizing various document elements. The functionality could directly address feature requests or bug fixes, though references to specific issues are not provided.
Added an overloaded constructor to the WordTextBox class to allow creating a text box with an existing WordParagraph object. This enables better reuse of paragraph instances and facilitates more flexible text box creation workflows.
Modified the `AddTextBox` method to default the text wrapping to 'Square', streamlining the text box creation process by reducing the need to specify common wrapping styles manually. This enhancement aims to improve usability for cases where the 'Square' wrapping style is frequently used.
Text box image wrapping now supports a `Drawing` object, enabling more precise wrap configuration. The `WrapText` property has been updated to utilize `Drawing`, ensuring better control over how text wraps around images. Additionally, two new methods, `ConvertInlineToAnchor` and `ConvertAnchorToInline`, have been introduced to facilitate conversion between inline and anchored text boxes, accommodating various text flow scenarios. This addresses layout customization needs for complex document structures.
[WordTextBox] Add additional features
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR adds the following features:
Breaking change:
WrapTextImage.InFrontTexttoWrapTextImage.InFrontOfTextto match Word naming