TextParagraph.h

#pragma once
// Copyright (c) 2001-2024 Aspose Pty Ltd. All Rights Reserved.

#include <system/array.h>
#include <cstdint>

#include "Aspose.PDF.Cpp/aspose_pdf_api_defs.h"

namespace Aspose
{
namespace Pdf
{
class Color;
namespace Engine
{
namespace CommonData
{
namespace Text
{
namespace Segmenting
{
class PhysicalTextSegment;
class SegmentsGroupState;
class TextSegmenter;
} // namespace Segmenting
} // namespace Text
} // namespace CommonData
} // namespace Engine
namespace Facades
{
class PdfFileMend;
} // namespace Facades
class Heading;
enum class HorizontalAlignment;
class MarginInfo;
class Matrix;
class PageGenerator;
class Rectangle;
namespace Tests
{
class RegressionTests_v9_9;
namespace Text
{
class TextBuilderTests;
class TextParagraphAbsorberTests;
} // namespace Text
} // namespace Tests
namespace Text
{
class Position;
class TextBuilder;
class TextEditOptions;
class TextFormattingOptions;
class TextFragment;
class TextFragmentCollection;
class TextSegment;
class TextSegmentCollection;
class TextState;
} // namespace Text
enum class VerticalAlignment;
} // namespace Pdf
} // namespace Aspose
namespace System
{
namespace Collections
{
namespace Generic
{
template <typename, typename> class Dictionary;
template <typename> class List;
} // namespace Generic
} // namespace Collections
} // namespace System

namespace Aspose {

namespace Pdf {

namespace Text {

class ASPOSE_PDF_SHARED_CLASS TextParagraph final : public System::Object
{
    typedef TextParagraph ThisType;
    typedef System::Object BaseType;
    
    typedef ::System::BaseTypesInfo<BaseType> ThisTypeBaseTypesInfo;
    ASPOSE_PDF_SHARED_RTTI_INFO_DECL();
    
    friend class Aspose::Pdf::Heading;
    friend class Aspose::Pdf::PageGenerator;
    friend class Aspose::Pdf::Facades::PdfFileMend;
    friend class Aspose::Pdf::Text::TextBuilder;
    friend class Aspose::Pdf::Tests::Text::TextParagraphAbsorberTests;
    friend class Aspose::Pdf::Tests::Text::TextBuilderTests;
    friend class Aspose::Pdf::Tests::RegressionTests_v9_9;
    
protected:

    enum class TextBackgroundMode
    {
        WholeParagraph,
        LogicalLine
    };
    
    
private:

    class IJustificationElement : public System::Object
    {
        typedef IJustificationElement ThisType;
        typedef System::Object BaseType;
        
        typedef ::System::BaseTypesInfo<BaseType> ThisTypeBaseTypesInfo;
        RTTI_INFO_DECL();
        
    };
    
    class JustificationWord : public Aspose::Pdf::Text::TextParagraph::IJustificationElement
    {
        typedef JustificationWord ThisType;
        typedef Aspose::Pdf::Text::TextParagraph::IJustificationElement BaseType;
        
        typedef ::System::BaseTypesInfo<BaseType> ThisTypeBaseTypesInfo;
        RTTI_INFO_DECL();
        
    public:
    
        System::String get_Word() const;
        void set_Word(System::String value);
        int32_t get_StartPos() const;
        void set_StartPos(int32_t value);
        int32_t get_EndPos() const;
        void set_EndPos(int32_t value);
        const System::SharedPtr<TextSegment>& get_InitialSegment() const;
        void set_InitialSegment(System::SharedPtr<TextSegment> value);
        double get_Width() const;
        void set_Width(double value);
        double get_SpaceWidth() const;
        void set_SpaceWidth(double value);
        
        JustificationWord();
        
    private:
    
        System::String pr_Word;
        int32_t pr_StartPos;
        int32_t pr_EndPos;
        System::SharedPtr<TextSegment> pr_InitialSegment;
        double pr_Width;
        double pr_SpaceWidth;
        
    };
    
    class JustificationSpace : public Aspose::Pdf::Text::TextParagraph::IJustificationElement
    {
        typedef JustificationSpace ThisType;
        typedef Aspose::Pdf::Text::TextParagraph::IJustificationElement BaseType;
        
        typedef ::System::BaseTypesInfo<BaseType> ThisTypeBaseTypesInfo;
        RTTI_INFO_DECL();
        
    public:
    
        const System::SharedPtr<TextSegment>& get_InitialSegment() const;
        void set_InitialSegment(System::SharedPtr<TextSegment> value);
        double get_SpaceWidth() const;
        void set_SpaceWidth(double value);
        
        JustificationSpace();
        
    private:
    
        System::SharedPtr<TextSegment> pr_InitialSegment;
        double pr_SpaceWidth;
        
    };
    
    
public:

    ASPOSE_PDF_SHARED_API Aspose::Pdf::VerticalAlignment get_VerticalAlignment() const;
    ASPOSE_PDF_SHARED_API void set_VerticalAlignment(Aspose::Pdf::VerticalAlignment value);
    ASPOSE_PDF_SHARED_API float get_SubsequentLinesIndent() const;
    ASPOSE_PDF_SHARED_API void set_SubsequentLinesIndent(float value);
    ASPOSE_PDF_SHARED_API float get_FirstLineIndent() const;
    ASPOSE_PDF_SHARED_API void set_FirstLineIndent(float value);
    ASPOSE_PDF_SHARED_API bool get_Justify();
    ASPOSE_PDF_SHARED_API void set_Justify(bool value);
    ASPOSE_PDF_SHARED_API Aspose::Pdf::HorizontalAlignment get_HorizontalAlignment() const;
    ASPOSE_PDF_SHARED_API void set_HorizontalAlignment(Aspose::Pdf::HorizontalAlignment value);
    ASPOSE_PDF_SHARED_API System::SharedPtr<TextFormattingOptions> get_FormattingOptions() const;
    ASPOSE_PDF_SHARED_API void set_FormattingOptions(System::SharedPtr<TextFormattingOptions> value);
    ASPOSE_PDF_SHARED_API System::SharedPtr<Aspose::Pdf::Text::Position> get_Position() const;
    ASPOSE_PDF_SHARED_API void set_Position(System::SharedPtr<Aspose::Pdf::Text::Position> value);
    ASPOSE_PDF_SHARED_API System::SharedPtr<Aspose::Pdf::Rectangle> get_TextRectangle();
    ASPOSE_PDF_SHARED_API System::SharedPtr<Aspose::Pdf::Rectangle> get_Rectangle() const;
    ASPOSE_PDF_SHARED_API void set_Rectangle(System::SharedPtr<Aspose::Pdf::Rectangle> value);
    ASPOSE_PDF_SHARED_API System::SharedPtr<MarginInfo> get_Margin() const;
    ASPOSE_PDF_SHARED_API void set_Margin(System::SharedPtr<MarginInfo> value);
    ASPOSE_PDF_SHARED_API double get_Rotation() const;
    ASPOSE_PDF_SHARED_API void set_Rotation(double value);
    
    ASPOSE_PDF_SHARED_API TextParagraph();
    
    ASPOSE_PDF_SHARED_API void BeginEdit();
    ASPOSE_PDF_SHARED_API void EndEdit();
    ASPOSE_PDF_SHARED_API void AppendLine(System::String line);
    ASPOSE_PDF_SHARED_API void AppendLine(System::String line, float lineSpacing);
    ASPOSE_PDF_SHARED_API void AppendLine(System::String line, System::SharedPtr<TextState> textState);
    ASPOSE_PDF_SHARED_API void AppendLine(System::String line, System::SharedPtr<TextState> textState, float lineSpacing);
    ASPOSE_PDF_SHARED_API void AppendLine(System::SharedPtr<TextFragment> line);
    ASPOSE_PDF_SHARED_API void AppendLine(System::SharedPtr<TextFragment> line, System::SharedPtr<TextState> textState);
    ASPOSE_PDF_SHARED_API void AppendLine(System::SharedPtr<TextFragment> line, System::SharedPtr<TextState> textState, float lineSpacing);
    
protected:

    const System::SharedPtr<System::Collections::Generic::Dictionary<int32_t, float>>& get_LineSpacings() const;
    System::String get_McName() const;
    int32_t get_McId() const;
    System::SharedPtr<Color> get_BackgroundColor() const;
    void set_BackgroundColor(System::SharedPtr<Color> value);
    bool get_LimitWithBounds() const;
    void set_LimitWithBounds(bool value);
    bool get_PreserveOriginalLinespacing() const;
    void set_PreserveOriginalLinespacing(bool value);
    System::String get_HyphenSymbol() const;
    void set_HyphenSymbol(System::String value);
    System::SharedPtr<TextFragmentCollection> get_Lines();
    System::SharedPtr<TextFragmentCollection> get_RemainingLines();
    System::SharedPtr<Aspose::Pdf::Rectangle> get_TextBox();
    System::SharedPtr<TextSegment> get_LastSegment();
    double get_LastFragmentHeight();
    System::SharedPtr<Aspose::Pdf::Matrix> get_Matrix() const;
    void set_Matrix(System::SharedPtr<Aspose::Pdf::Matrix> value);
    bool get_OldCodeCompatibilityMode() const;
    void set_OldCodeCompatibilityMode(bool value);
    TextParagraph::TextBackgroundMode get_BackgroundMode() const;
    void set_BackgroundMode(TextParagraph::TextBackgroundMode value);
    System::SharedPtr<Aspose::Pdf::Engine::CommonData::Text::Segmenting::SegmentsGroupState> get_GroupState() const;
    void set_GroupState(System::SharedPtr<Aspose::Pdf::Engine::CommonData::Text::Segmenting::SegmentsGroupState> value);
    System::SharedPtr<System::Collections::Generic::List<System::SharedPtr<Aspose::Pdf::Engine::CommonData::Text::Segmenting::SegmentsGroupState>>> get_LineGroupStates() const;
    void set_LineGroupStates(System::SharedPtr<System::Collections::Generic::List<System::SharedPtr<Aspose::Pdf::Engine::CommonData::Text::Segmenting::SegmentsGroupState>>> value);
    System::SharedPtr<System::Collections::Generic::Dictionary<int32_t, System::String>> get_LineEndReasons() const;
    
    void Attach(System::SharedPtr<Aspose::Pdf::Engine::CommonData::Text::Segmenting::TextSegmenter> segmenter);
    void RemoveLineByIndex(int32_t index);
    void InsertAtBeginning(System::SharedPtr<TextFragment> line, System::SharedPtr<TextSegment> segmentInserted);
    void AddToEnd(System::SharedPtr<TextFragment> line, System::SharedPtr<TextSegment> segmentAdded);
    
private:

    System::SharedPtr<TextFragmentCollection> outLines;
    System::SharedPtr<TextFragmentCollection> remainingLines;
    System::SharedPtr<TextFragmentCollection> inLines;
    bool updatingPositioning;
    System::SharedPtr<TextFormattingOptions> formattingOptions;
    System::SharedPtr<Aspose::Pdf::Matrix> matrix;
    System::SharedPtr<Aspose::Pdf::Text::Position> position;
    System::SharedPtr<Aspose::Pdf::Rectangle> rectangle;
    System::SharedPtr<Aspose::Pdf::Rectangle> textRectangle;
    System::SharedPtr<Aspose::Pdf::Rectangle> textBox;
    System::SharedPtr<Aspose::Pdf::Rectangle> insideMarginRect;
    System::SharedPtr<Aspose::Pdf::Text::Position> insideMarginPosition;
    System::SharedPtr<Aspose::Pdf::Rectangle> bgRectangle;
    System::SharedPtr<Aspose::Pdf::Rectangle> clipRectangle;
    System::SharedPtr<Aspose::Pdf::Engine::CommonData::Text::Segmenting::TextSegmenter> segmenter;
    System::SharedPtr<System::Collections::Generic::Dictionary<int32_t, float>> pr_LineSpacings;
    
    void set_LineSpacings(System::SharedPtr<System::Collections::Generic::Dictionary<int32_t, float>> value);
    
    System::SharedPtr<System::Object> sync;
    System::SharedPtr<MarginInfo> marginInfo;
    Aspose::Pdf::VerticalAlignment verticalAlignment;
    Aspose::Pdf::HorizontalAlignment horizontalAlignment;
    System::SharedPtr<Color> backgroundColor;
    double rotation;
    bool isAttached;
    int32_t clipsCount;
    System::String hyphenSymbol;
    bool limitWithBounds;
    bool isEditing;
    int32_t suspendedUpdateRequest;
    float subsequentLinesIndent;
    float firstLineIndent;
    bool preserveOriginalLinespacing;
    static const float DefaultSpacing;
    bool _oldCodeCompatibilityMode;
    TextParagraph::TextBackgroundMode _backgroundMode;
    System::SharedPtr<System::Collections::Generic::Dictionary<int32_t, System::String>> _lineEndReasons;
    static const int32_t MagicDeltaHeight;
    static const int32_t FontLinedeltaHeight;
    static const int32_t DeltaLeft;
    static const int32_t DeltaRight;
    static const int32_t DeltaHeight;
    static const int32_t DeltaUp;
    static const int32_t DeltaBottom;
    static const int32_t EmulatedItalicRightCorrection;
    System::String pr_McName;
    
    void set_McName(System::String value);
    
    int32_t pr_McId;
    
    void set_McId(int32_t value);
    
    System::SharedPtr<Aspose::Pdf::Engine::CommonData::Text::Segmenting::SegmentsGroupState> _groupState;
    System::SharedPtr<System::Collections::Generic::List<System::SharedPtr<Aspose::Pdf::Engine::CommonData::Text::Segmenting::SegmentsGroupState>>> _lineGroupStates;
    
    System::SharedPtr<Aspose::Pdf::Rectangle> get_InsideMarginRectangle();
    System::SharedPtr<Aspose::Pdf::Text::Position> get_InsideMarginPosition();
    
    void UpdateTextRectangle(double textHeight, double textMaxWidth, double& dx, double& dy);
    void UpdateMatrixCoordinates();
    void UpdatePositioningInEditingMode();
    void UpdatePositioning();
    void UpdatePositioning(bool forceUpdate);
    void ShiftSegment(double shiftDx, double shiftDy);
    double DoWrapPositioning();
    double ComputeLength(System::String input, System::SharedPtr<TextState> textState, int32_t key);
    float GetLineIndent(bool isFirstLine);
    void InsertLineWrapLog(int32_t index);
    double DoNoWrapPositioning();
    void AddLineToRemaining(System::SharedPtr<TextFragment> inLine);
    static void SkipSpaces(int32_t& j, int32_t charCount, System::String txt);
    bool FlushPotentialLine(System::SharedPtr<TextFragment> outLine, bool fillRemainingLines, System::SharedPtr<TextSegmentCollection> remainingLine, System::SharedPtr<TextSegmentCollection> potentialLine, double nextLineShift, float indent, bool isLastSubline);
    void PositionSegmentsLeft(System::SharedPtr<TextSegmentCollection> ponentialLine, double nextLineShift, float indent);
    void PositionSegmentsCenter(System::SharedPtr<TextSegmentCollection> ponentialLine, double nextLineShift, float indent);
    void PositionSegmentsRight(System::SharedPtr<TextSegmentCollection> potentialLine, double nextLineShift, float indent);
    void PositionSegmentsJustify(System::SharedPtr<TextSegmentCollection> ponentialLine, double nextLineShift, float indent);
    double ComputeLineShift(int32_t currentLineIndex, System::SharedPtr<TextSegmentCollection> ponentialLine);
    static void AddNewLine(int32_t& lineIndex, System::SharedPtr<System::Collections::Generic::List<System::SharedPtr<TextSegmentCollection>>> newLines);
    float GetLineSpacingBeforeIndex(System::SharedPtr<TextSegmentCollection> line, int32_t i);
    System::SharedPtr<TextSegment> CreateNewSegment(System::String text, System::SharedPtr<TextState> state, bool allowAttachment);
    System::SharedPtr<TextSegment> CreateNewSegment(System::String text, System::SharedPtr<TextState> state, bool allowAttachment, System::SharedPtr<TextEditOptions> opts);
    void ClearPhysicalSegments();
    void FlushDetachedProperties();
    void FlushBGColor();
    void FlushClipBox();
    double ComputeMaxTextHeight(System::SharedPtr<TextSegmentCollection> segments);
    void CorrectRegardingMatrix(System::SharedPtr<TextFragment> textFragment, System::SharedPtr<Aspose::Pdf::Rectangle> newRect);
    void CorrectRegardingMatrix(System::SharedPtr<TextFragmentCollection> textFragments, System::SharedPtr<Aspose::Pdf::Rectangle>& newRect);
    System::ArrayPtr<System::SharedPtr<Aspose::Pdf::Engine::CommonData::Text::Segmenting::PhysicalTextSegment>> LinesToSegments();
    void ResetBoxProperties();
    void AppendLineInternal(System::SharedPtr<TextFragment> fragement, System::SharedPtr<TextState> textState, float lineSpacing);
    void SplitAndAddSublines(System::String line, System::SharedPtr<TextState> textState, float lineSpacing);
    void SplitAndAddSublinesFragment(System::SharedPtr<TextFragment> fragment, System::SharedPtr<TextState> textState, float lineSpacing);
    void CheckForSubstitutionAdd(System::SharedPtr<TextFragment> line, System::SharedPtr<TextState> textState, float lineSpacing);
    void SubstituteToChunksAndAddSublines(System::String line, System::SharedPtr<TextState> textState);
    bool IsSeparatorLastIn(System::SharedPtr<TextSegmentCollection> potentialLine);
    static System::String GetTextWrapNotificationMessage(System::SharedPtr<TextFragment> line);
    
};

} // namespace Text
} // namespace Pdf
} // namespace Aspose