summaryrefslogtreecommitdiff
path: root/sw/inc/ToxTabStopTokenHandler.hxx
blob: f951fb22958386330ae415cbb07f0f16fc81cb05 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 */


#ifndef TOXTABSTOPTOKENHANDLER_HXX_
#define TOXTABSTOPTOKENHANDLER_HXX_

#include <rtl/ustring.hxx>

#include <editeng/tstpitem.hxx>

struct SwFormToken;
class SwPageDesc;
class SwRootFrame;
class SwTextNode;

namespace sw {

/** This class handles tab stop tokens in the pattern for tox entries.
 *
 * @internal
 * This is an interface class. It allows to mock the class in unit tests
 */
class ToxTabStopTokenHandler
{
public:
    virtual ~ToxTabStopTokenHandler() {}

    /** Return value of HandleTabStopToken */
    struct HandledTabStopToken {
        OUString text;
        SvxTabStop tabStop;
    };

    /** Handle a tab stop token.
     *
     * @returns A HandledTabStopToken. Make sure to append the text field to the text of the target node
     *          and to provide the returned SvxTabStop to the attributes of the node.
     */
    virtual HandledTabStopToken
    HandleTabStopToken(const SwFormToken& aToken, const SwTextNode& targetNode,
            const SwRootFrame *currentLayout) const = 0;
};

/** The default implementation of ToxTabStopTokenHandler */
class DefaultToxTabStopTokenHandler final : public ToxTabStopTokenHandler
{
public:

    enum TabStopReferencePolicy {TABSTOPS_RELATIVE_TO_INDENT, TABSTOPS_RELATIVE_TO_PAGE};

    /**
    * @param indexOfSectionNode
    * The index of the section node. It is needed to determine whether a page description was given by a node
    * before the tox section.
    *
    * @param defaultPageDescription
    * Which page description shall be used if we do not find one or the found page description was provided by
    * a node before the tox section
    *
    * @param tabPositionIsRelativeToParagraphIndent
    * Whether the tab position is relative to the paragraph indent. (toxForm.IsRelTabPos() is true or false.)
    *
    * @param tabstopReferencePolicy
    * How tab stops are positioned. (#i21237) The default behavior is to place tab stops relative to the page.
    */
    DefaultToxTabStopTokenHandler(sal_uInt32 indexOfSectionNode, const SwPageDesc& defaultPageDescription,
            bool tabPositionIsRelativeToParagraphIndent,
            TabStopReferencePolicy referencePolicy);

    /** Handle a tab stop token.
     *
     * If the token contains tab alignment information, that is used to create the SvxTabStop.
     * Else, the information about the tab stop is taken from a page description.
     * Depending on the TabStopReferencePolicy provided in the constructor, the
     * method behaves differently when deriving the tab stop position.
     */
    ToxTabStopTokenHandler::HandledTabStopToken
    HandleTabStopToken(const SwFormToken& aToken, const SwTextNode& targetNode,
            const SwRootFrame *currentLayout) const override;

private:
    /** Test whether the page layout can be obtained by a layout rectangle.
     *
     * Is used to determine how to find tab stop position.
     */
    static bool
    CanUseLayoutRectangle(const SwTextNode& targetNode, const SwRootFrame *currentLayout);

    /** Calculate the page margin from the page description.
     *
     * This is the fallback method to determine the position of a tab stop.
     */
    long
    CalculatePageMarginFromPageDescription(const SwTextNode& targetNode) const;

    sal_uInt32 const mIndexOfSectionNode;
    const SwPageDesc& mDefaultPageDescription;
    bool const mTabPositionIsRelativeToParagraphIndent;
    TabStopReferencePolicy const mTabStopReferencePolicy;
};

}

#endif /* TOXTABSTOPTOKENHANDLER_HXX_ */

/* vim:set shiftwidth=4 softtabstop=4 expandtab: */