Version 5.4.3.2, tag libreoffice-5.4.3.2
[LibreOffice.git] / include / svx / sdtakitm.hxx
blob8d628ac2d3d0952a23bd9741843fa26cecb6b68e
1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 /*
3 * This file is part of the LibreOffice project.
5 * This Source Code Form is subject to the terms of the Mozilla Public
6 * License, v. 2.0. If a copy of the MPL was not distributed with this
7 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
9 * This file incorporates work covered by the following license notice:
11 * Licensed to the Apache Software Foundation (ASF) under one or more
12 * contributor license agreements. See the NOTICE file distributed
13 * with this work for additional information regarding copyright
14 * ownership. The ASF licenses this file to you under the Apache
15 * License, Version 2.0 (the "License"); you may not use this file
16 * except in compliance with the License. You may obtain a copy of
17 * the License at http://www.apache.org/licenses/LICENSE-2.0 .
19 #ifndef INCLUDED_SVX_SDTAKITM_HXX
20 #define INCLUDED_SVX_SDTAKITM_HXX
22 #include <svl/eitem.hxx>
23 #include <svx/svddef.hxx>
24 #include <svx/svxdllapi.h>
26 /**
27 * Animation type for text frame.
29 enum class SdrTextAniKind {
30 NONE, /// no animation
31 Blink, /// blinking
32 Scroll, /// scroll through
33 Alternate, /// scroll back and forth
34 Slide /// scroll in
37 // - SdrTextAniKind::Blink:
38 // Just blink. Direction and Amount don't effect things.
39 // Frequency delay: 0 = 0.5Hz (Delay = 250).
40 // Count = number of blinks. (0 = forever)
41 // start inside: sal_False = begin with the blinker off, sal_True = begin with the blinker on
42 // stop inside: sal_False = end with the blinker off, sal_True = end with the blinker on
43 // (Only if count! = 0)
44 // - SdrTextAniKind::Scroll:
45 // Text just scrolls all the way through, and starts over when it is done.
47 // Delay in ms: (except delay = 0 means 50ms (20Hz) default)
48 // Count = number of passes (0 = go forever)
49 // Direction: the direction to scroll
50 // StartInside: sal_False = on the first pass, scroll the text in (not initially visible)
51 // sal_True = on the first pass, the left part of the text is already visible
52 // in the scroll area before starting.
53 // StopInside: sal_False = on the last pass, scroll the text all the way out.
54 // sal_True = on the last pass, keep the right part of the text visible.
55 // (Only if count! = 0)
56 // Amount: Step size in logical units. Negative values = use Pixels instead
57 // of logical units. If Amount = 0, then default to 1 Pixel.
58 // - SdrTextAniKind::Alternate:
59 // Like SdrTextAniKind::Scroll, except don't scroll until all of the text is out,
60 // but just until the last part is visible. Then, change direction and
61 // scroll the text the other way.
62 // Count = number of passes (number of direction changes minus 1)
63 // If count = 1, this is the same as SdrTextAniKind::Scroll
64 // Direction = the starting direction.
65 // All Other Parameters: just like SdrTextAniKind::Scroll
66 // - SdrTextAniKind::Slide:
67 // Text will slide in to the original position.
68 // -> same as SCROLL with StartInside = sal_False, StopInside = sal_True
69 // and Count = 1 (Count = 0 is interpreted as count = 1).
70 // For each count > 1, the text, will be slid out backwards
71 // (much like ALTERNATE) and then slid back in again.
72 // StopInside is not evaluated, because inside is always stopped.
73 // StartInside is not evaluated, because outside is always started.
74 // All other parameters are like SdrTextAniKind::Scroll
75 // StartInside, StopInside: When sal_True, the starting / final position
76 // of the text depends on the anchor of the drawing object. This
77 // corresponds to the position of the text in normal Paint (without scrolling).
79 class SVX_DLLPUBLIC SdrTextAniKindItem: public SfxEnumItem<SdrTextAniKind> {
80 public:
81 SdrTextAniKindItem(SdrTextAniKind eKind=SdrTextAniKind::NONE): SfxEnumItem(SDRATTR_TEXT_ANIKIND, eKind) {}
82 SdrTextAniKindItem(SvStream& rIn) : SfxEnumItem(SDRATTR_TEXT_ANIKIND, rIn) {}
83 virtual SfxPoolItem* Clone(SfxItemPool* pPool=nullptr) const override;
84 virtual SfxPoolItem* Create(SvStream& rIn, sal_uInt16 nVer) const override;
85 virtual sal_uInt16 GetValueCount() const override; // { return 5; }
87 virtual bool QueryValue( css::uno::Any& rVal, sal_uInt8 nMemberId = 0 ) const override;
88 virtual bool PutValue( const css::uno::Any& rVal, sal_uInt8 nMemberId ) override;
90 virtual OUString GetValueTextByPos(sal_uInt16 nPos) const override;
91 virtual bool GetPresentation(SfxItemPresentation ePres, MapUnit eCoreMetric, MapUnit ePresMetric, OUString& rText, const IntlWrapper * = nullptr) const override;
94 #endif
96 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */