office-gobmx/include/editeng/boxitem.hxx
Tomaž Vajngerl 92fc0ace46 ooxml: import and export border theme colors for various props.
This adds support to import and export various border (lines)
theme color properties.

SvxBoxItem needed to be fixed, because it can happen that the
BorderLine is not yet initialised and we already set the border's
ComplexColor. Now there is a maTempComplexColor inside SvxBoxItem,
which stores the ComplexColor until the specific BorderLine is
initialized.

In addition add roundtrip test for import and export cycle.

Change-Id: Idd307a3adaf364745aed8fc8540bf72ef4948198
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/152833
Tested-by: Jenkins
Reviewed-by: Tomaž Vajngerl <quikee@gmail.com>
2023-06-12 03:54:48 +02:00

311 lines
11 KiB
C++

/* -*- 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/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
*/
#ifndef INCLUDED_EDITENG_BOXITEM_HXX
#define INCLUDED_EDITENG_BOXITEM_HXX
#include <svl/poolitem.hxx>
#include <editeng/editengdllapi.h>
#include <com/sun/star/table/BorderLine2.hpp>
#include <o3tl/typed_flags_set.hxx>
#include <docmodel/color/ComplexColor.hxx>
#include <memory>
#include <array>
namespace editeng { class SvxBorderLine; }
// class SvxBoxItem ------------------------------------------------------
/* [Description]
This item describes a border attribute
(all four edges and the inward distance)
*/
enum class SvxBoxItemLine
{
TOP, BOTTOM, LEFT, RIGHT, LAST = RIGHT
};
/**
This version causes SvxBoxItem to store the 4 cell spacing distances separately
when serializing to stream.
*/
constexpr sal_uInt16 BOX_4DISTS_VERSION = 1;
/**
This version causes SvxBoxItem to store the styles for its border lines when
serializing to stream.
*/
constexpr sal_uInt16 BOX_BORDER_STYLE_VERSION = 2;
class EDITENG_DLLPUBLIC SvxBoxItem final : public SfxPoolItem
{
std::unique_ptr<editeng::SvxBorderLine> mpTopBorderLine;
std::unique_ptr<editeng::SvxBorderLine> mpBottomBorderLine;
std::unique_ptr<editeng::SvxBorderLine> mpLeftBorderLine;
std::unique_ptr<editeng::SvxBorderLine> mpRightBorderLine;
sal_Int16 mnTopDistance = 0;
sal_Int16 mnBottomDistance = 0;
sal_Int16 mnLeftDistance = 0;
sal_Int16 mnRightDistance = 0;
// Store complex colors until lines are created...
std::array<model::ComplexColor, 4> maTempComplexColors;
bool mbRemoveAdjCellBorder = false;
void tryMigrateComplexColor(SvxBoxItemLine eLine);
public:
static SfxPoolItem* CreateDefault();
explicit SvxBoxItem( const sal_uInt16 nId );
SvxBoxItem( const SvxBoxItem &rCpy );
virtual ~SvxBoxItem() override;
// "pure virtual Methods" from SfxPoolItem
virtual bool operator==( const SfxPoolItem& ) const override;
virtual bool QueryValue( css::uno::Any& rVal, sal_uInt8 nMemberId = 0 ) const override;
virtual bool PutValue( const css::uno::Any& rVal, sal_uInt8 nMemberId ) override;
virtual bool GetPresentation( SfxItemPresentation ePres,
MapUnit eCoreMetric,
MapUnit ePresMetric,
OUString &rText, const IntlWrapper& ) const override;
virtual SvxBoxItem* Clone( SfxItemPool *pPool = nullptr ) const override;
virtual void ScaleMetrics( tools::Long nMult, tools::Long nDiv ) override;
virtual bool HasMetrics() const override;
const editeng::SvxBorderLine* GetTop() const
{
return mpTopBorderLine.get();
}
const editeng::SvxBorderLine* GetBottom() const
{
return mpBottomBorderLine.get();
}
const editeng::SvxBorderLine* GetLeft() const
{
return mpLeftBorderLine.get();
}
const editeng::SvxBorderLine* GetRight() const
{
return mpRightBorderLine.get();
}
editeng::SvxBorderLine* GetTop()
{
return mpTopBorderLine.get();
}
editeng::SvxBorderLine* GetBottom()
{
return mpBottomBorderLine.get();
}
editeng::SvxBorderLine* GetLeft()
{
return mpLeftBorderLine.get();
}
editeng::SvxBorderLine* GetRight()
{
return mpRightBorderLine.get();
}
const editeng::SvxBorderLine* GetLine( SvxBoxItemLine nLine ) const;
//The Pointers are being copied!
void SetLine( const editeng::SvxBorderLine* pNew, SvxBoxItemLine nLine );
sal_Int16 GetDistance( SvxBoxItemLine nLine, bool bAllowNegative = false ) const;
sal_uInt16 GetSmallestDistance() const;
bool IsRemoveAdjacentCellBorder() const { return mbRemoveAdjCellBorder; }
void SetDistance( sal_Int16 nNew, SvxBoxItemLine nLine );
void SetAllDistances(sal_Int16 nNew)
{
mnTopDistance = mnBottomDistance = mnLeftDistance = mnRightDistance = nNew;
}
void SetRemoveAdjacentCellBorder( bool bSet ) { mbRemoveAdjCellBorder = bSet; }
// Line width plus Space plus inward distance
// bEvenIfNoLine = TRUE -> Also return distance, when no Line is set
sal_uInt16 CalcLineWidth( SvxBoxItemLine nLine ) const;
sal_Int16 CalcLineSpace( SvxBoxItemLine nLine, bool bEvenIfNoLine = false, bool bAllowNegative = false ) const;
bool HasBorder( bool bTreatPaddingAsBorder ) const;
static css::table::BorderLine2 SvxLineToLine( const editeng::SvxBorderLine* pLine, bool bConvert );
static bool LineToSvxLine(const css::table::BorderLine& rLine, editeng::SvxBorderLine& rSvxLine, bool bConvert);
static bool LineToSvxLine(const css::table::BorderLine2& rLine, editeng::SvxBorderLine& rSvxLine, bool bConvert);
virtual boost::property_tree::ptree dumpAsJSON() const override;
void dumpAsXml(xmlTextWriterPtr pWriter) const override;
};
// class SvxBoxInfoItem --------------------------------------------------
/* [Description]
Another item for the border. This item has only limited functionality.
On one hand, the general Dialog is told by the item which options it
should offer. On the other hand, this attribute may be used to
transported the borderline for the inner horizontal and vertical lines.
*/
enum class SvxBoxInfoItemLine
{
HORI, VERT, LAST = VERT
};
enum class SvxBoxInfoItemValidFlags
{
NONE = 0x00,
TOP = 0x01,
BOTTOM = 0x02,
LEFT = 0x04,
RIGHT = 0x08,
HORI = 0x10,
VERT = 0x20,
DISTANCE = 0x40,
DISABLE = 0x80,
ALL = 0xff
};
namespace o3tl
{
template<> struct typed_flags<SvxBoxInfoItemValidFlags> : is_typed_flags<SvxBoxInfoItemValidFlags, 0xff> {};
}
class EDITENG_DLLPUBLIC SvxBoxInfoItem final : public SfxPoolItem
{
std::unique_ptr<editeng::SvxBorderLine> mpHorizontalLine; //inner horizontal Line
std::unique_ptr<editeng::SvxBorderLine> mpVerticalLine; //inner vertical Line
bool mbEnableHorizontalLine = false; /// true = Enable inner horizontal line.
bool mbEnableVerticalLine = false; /// true = Enable inner vertical line.
/*
Currently only for StarWriter: distance inward from SvxBoxItem. If the
distance is requested, then the field for the distance from the dialog be
activated. nDefDist is regarded as a default value. If any line is
turned on or will be turned on it must this distance be set to default.
bMinDist indicates whether the user can go below this value or not.
With NDIST is the current distance from the app transported back and
forth to the dialogue.
*/
bool mbDistance :1; // TRUE, Unlock Distance.
bool mbMinimumDistance :1; // TRUE, Going below minimum Distance is prohibited
SvxBoxInfoItemValidFlags mnValidFlags;
sal_uInt16 mnDefaultMinimumDistance = 0; // The default or minimum distance.
public:
static SfxPoolItem* CreateDefault();
explicit SvxBoxInfoItem( const sal_uInt16 nId );
SvxBoxInfoItem( const SvxBoxInfoItem &rCpy );
virtual ~SvxBoxInfoItem() override;
// "pure virtual Methods" from SfxPoolItem
virtual bool operator==( const SfxPoolItem& ) const override;
virtual bool GetPresentation( SfxItemPresentation ePres,
MapUnit eCoreMetric,
MapUnit ePresMetric,
OUString &rText, const IntlWrapper& ) const override;
virtual bool QueryValue( css::uno::Any& rVal, sal_uInt8 nMemberId = 0 ) const override;
virtual bool PutValue( const css::uno::Any& rVal, sal_uInt8 nMemberId ) override;
virtual SvxBoxInfoItem* Clone( SfxItemPool *pPool = nullptr ) const override;
virtual void ScaleMetrics( tools::Long nMult, tools::Long nDiv ) override;
virtual bool HasMetrics() const override;
const editeng::SvxBorderLine* GetHori() const { return mpHorizontalLine.get(); }
const editeng::SvxBorderLine* GetVert() const { return mpVerticalLine.get(); }
//The Pointers are being copied!
void SetLine( const editeng::SvxBorderLine* pNew, SvxBoxInfoItemLine nLine );
bool IsTable() const { return mbEnableHorizontalLine && mbEnableVerticalLine; }
void SetTable(bool bNew) { mbEnableHorizontalLine = mbEnableVerticalLine = bNew; }
bool IsHorEnabled() const { return mbEnableHorizontalLine; }
void EnableHor( bool bEnable ) { mbEnableHorizontalLine = bEnable; }
bool IsVerEnabled() const { return mbEnableVerticalLine; }
void EnableVer( bool bEnable ) { mbEnableVerticalLine = bEnable; }
bool IsDist() const { return mbDistance; }
void SetDist(bool bNew)
{
mbDistance = bNew;
}
bool IsMinDist() const { return mbMinimumDistance; }
void SetMinDist(bool bNew) { mbMinimumDistance = bNew; }
sal_uInt16 GetDefDist() const { return mnDefaultMinimumDistance; }
void SetDefDist(sal_uInt16 nNew) { mnDefaultMinimumDistance = nNew; }
bool IsValid( SvxBoxInfoItemValidFlags nValid ) const
{
return bool(mnValidFlags & nValid);
}
void SetValid(SvxBoxInfoItemValidFlags nValid, bool bValid = true)
{
if (bValid)
mnValidFlags |= nValid;
else
mnValidFlags &= ~nValid;
}
void ResetFlags();
virtual boost::property_tree::ptree dumpAsJSON() const override;
};
namespace editeng
{
void EDITENG_DLLPUBLIC BorderDistanceFromWord(bool bFromEdge, sal_Int32& nMargin,
sal_Int32& nBorderDistance, sal_Int32 nBorderWidth);
struct EDITENG_DLLPUBLIC WordPageMargins final
{
sal_uInt16 nLeft = 0;
sal_uInt16 nRight = 0;
sal_uInt16 nTop = 0;
sal_uInt16 nBottom = 0;
};
struct EDITENG_DLLPUBLIC WordBorderDistances final
{
bool bFromEdge = false;
sal_uInt16 nLeft = 0;
sal_uInt16 nRight = 0;
sal_uInt16 nTop = 0;
sal_uInt16 nBottom = 0;
};
// Heuristics to decide if we need to use "from edge" offset of borders. All sizes in twips
void EDITENG_DLLPUBLIC BorderDistancesToWord(const SvxBoxItem& rBox, const WordPageMargins& rMargins,
WordBorderDistances& rDistances);
}
#endif
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */