sw/source/uibase/docvw/PageBreakWin.cxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   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/.
   8  */
   9
  10 #include <bitmaps.hlst>
  11
  12 #include <cmdid.h>
  13 #include <cntfrm.hxx>
  14 #include <txtfrm.hxx>
  15 #include <notxtfrm.hxx>
  16 #include <ndtxt.hxx>
  17 #include <DashedLine.hxx>
  18 #include <doc.hxx>
  19 #include <edtwin.hxx>
  20 #include <fmtpdsc.hxx>
  21 #include <IDocumentUndoRedo.hxx>
  22 #include <IDocumentContentOperations.hxx>
  23 #include <PageBreakWin.hxx>
  24 #include <pagefrm.hxx>
  25 #include <PostItMgr.hxx>
  26 #include <FrameControlsManager.hxx>
  27 #include <strings.hrc>
  28 #include <tabfrm.hxx>
  29 #include <uiitems.hxx>
  30 #include <uiobject.hxx>
  31 #include <view.hxx>
  32 #include <viewopt.hxx>
  33 #include <wrtsh.hxx>
  34
  35 #include <basegfx/color/bcolortools.hxx>
  36 #include <basegfx/polygon/b2dpolygon.hxx>
  37 #include <basegfx/polygon/b2dpolygontools.hxx>
  38 #include <basegfx/range/b2drectangle.hxx>
  39 #include <drawinglayer/primitive2d/discretebitmapprimitive2d.hxx>
  40 #include <drawinglayer/primitive2d/modifiedcolorprimitive2d.hxx>
  41 #include <drawinglayer/primitive2d/PolygonHairlinePrimitive2D.hxx>
  42 #include <drawinglayer/primitive2d/PolyPolygonColorPrimitive2D.hxx>
  43 #include <drawinglayer/processor2d/baseprocessor2d.hxx>
  44 #include <drawinglayer/processor2d/processor2dtools.hxx>
  45 #include <editeng/formatbreakitem.hxx>
  46 #include <sfx2/dispatch.hxx>
  47 #include <sfx2/viewfrm.hxx>
  48 #include <svl/stritem.hxx>
  49 #include <vcl/canvastools.hxx>
  50 #include <vcl/event.hxx>
  51 #include <vcl/svapp.hxx>
  52 #include <vcl/settings.hxx>
  53 #include <memory>
  54
  55 #define BUTTON_WIDTH 30
  56 #define BUTTON_HEIGHT 19
  57 #define ARROW_WIDTH 9
  58
  59 using namespace basegfx;
  60 using namespace basegfx::utils;
  61
  62 SwBreakDashedLine::SwBreakDashedLine(SwEditWin* pEditWin, const SwFrame *pFrame)
  63     : SwDashedLine(pEditWin, &SwViewOption::GetPageBreakColor)
  64     , m_pEditWin(pEditWin)
  65     , m_pFrame(pFrame)
  66 {
  67     set_id("PageBreak"); // for uitest
  68 }
  69
  70 SwPageBreakWin& SwBreakDashedLine::GetOrCreateWin()
  71 {
  72     if (!m_pWin)
  73     {
  74         m_pWin = VclPtr<SwPageBreakWin>::Create(this, m_pEditWin, m_pFrame);
  75         m_pWin->SetPosSizePixel(m_aBtnRect.TopLeft(), m_aBtnRect.GetSize());
  76         m_pWin->SetZOrder(this, ZOrderFlags::Before);
  77     }
  78     return *m_pWin;
  79 }
  80
  81 void SwBreakDashedLine::DestroyWin()
  82 {
  83     m_pWin.disposeAndClear();
  84 }
  85
  86 void SwBreakDashedLine::MouseMove( const MouseEvent& rMEvt )
  87 {
  88     if ( rMEvt.IsLeaveWindow() )
  89     {
  90         // don't fade if we just move to the 'button'
  91         Point aEventPos( GetPosPixel() + rMEvt.GetPosPixel() );
  92         if (m_pWin && (!Contains(aEventPos) || !m_pWin->IsVisible()))
  93             m_pWin->Fade(false);
  94     }
  95     else if (!m_pWin || !m_pWin->IsVisible())
  96     {
  97         GetOrCreateWin().Fade(true);
  98     }
  99
 100     if (!rMEvt.IsSynthetic() && (!m_pWin || !m_pWin->IsVisible()))
 101     {
 102         UpdatePosition(rMEvt.GetPosPixel());
 103     }
 104 }
 105
 106 void SwBreakDashedLine::ShowAll(bool bShow)
 107 {
 108     Show(bShow);
 109 }
 110
 111 void SwBreakDashedLine::SetReadonly(bool bReadonly)
 112 {
 113     ShowAll(!bReadonly);
 114 }
 115
 116 bool SwBreakDashedLine::Contains(const Point &rDocPt) const
 117 {
 118     if (m_aBtnRect.Contains(rDocPt))
 119         return true;
 120
 121     ::tools::Rectangle aLineRect(GetPosPixel(), GetSizePixel());
 122     return aLineRect.Contains(rDocPt);
 123 }
 124
 125 SwPageBreakWin::SwPageBreakWin(SwBreakDashedLine* pLine, SwEditWin* pEditWin, const SwFrame *pFrame) :
 126     InterimItemWindow(pEditWin, "modules/swriter/ui/pbmenubutton.ui", "PBMenuButton"),
 127     m_xMenuButton(m_xBuilder->weld_menu_button("menubutton")),
 128     m_pLine(pLine),
 129     m_pEditWin(pEditWin),
 130     m_pFrame(pFrame),
 131     m_bIsAppearing( false ),
 132     m_nFadeRate( 100 ),
 133     m_nDelayAppearing( 0 ),
 134     m_aFadeTimer("SwPageBreakWin m_aFadeTimer"),
 135     m_bDestroyed( false )
 136 {
 137     m_xMenuButton->connect_toggled(LINK(this, SwPageBreakWin, ToggleHdl));
 138     m_xMenuButton->connect_selected(LINK(this, SwPageBreakWin, SelectHdl));
 139     m_xMenuButton->set_accessible_name(SwResId(STR_PAGE_BREAK_BUTTON));
 140
 141     m_xVirDev = m_xMenuButton->create_virtual_device();
 142     SwFrameMenuButtonBase::SetVirDevFont(*m_xVirDev);
 143
 144     // Use pixels for the rest of the drawing
 145     m_xVirDev->SetMapMode( MapMode ( MapUnit::MapPixel ) );
 146
 147     m_aFadeTimer.SetTimeout( 50 );
 148     m_aFadeTimer.SetInvokeHandler( LINK( this, SwPageBreakWin, FadeHandler ) );
 149 }
 150
 151 SwPageBreakWin::~SwPageBreakWin( )
 152 {
 153     disposeOnce();
 154 }
 155
 156 void SwPageBreakWin::dispose()
 157 {
 158     m_bDestroyed = true;
 159     m_aFadeTimer.Stop();
 160     m_xVirDev.disposeAndClear();
 161
 162     m_pLine.clear();
 163     m_pEditWin.clear();
 164
 165     m_xMenuButton.reset();
 166     InterimItemWindow::dispose();
 167 }
 168
 169 void SwPageBreakWin::PaintButton()
 170 {
 171     if (!m_xVirDev)
 172         return;
 173
 174     const ::tools::Rectangle aRect(::tools::Rectangle(Point(0, 0), m_xVirDev->PixelToLogic(GetSizePixel())));
 175
 176     // Properly paint the control
 177     BColor aColor = SwViewOption::GetCurrentViewOptions().GetPageBreakColor().getBColor();
 178
 179     BColor aHslLine = rgb2hsl(aColor);
 180     double nLuminance = aHslLine.getZ();
 181     nLuminance += (1.0 - nLuminance) * 0.75;
 182     if ( aHslLine.getZ() > 0.7 )
 183         nLuminance = aHslLine.getZ() * 0.7;
 184     aHslLine.setZ(nLuminance);
 185     BColor aOtherColor = hsl2rgb(aHslLine);
 186
 187     const StyleSettings& rSettings = Application::GetSettings().GetStyleSettings();
 188     if (rSettings.GetHighContrastMode())
 189     {
 190         aColor = rSettings.GetDialogTextColor().getBColor();
 191         aOtherColor = rSettings.GetDialogColor().getBColor();
 192     }
 193
 194     bool bRtl = AllSettings::GetLayoutRTL();
 195
 196     drawinglayer::primitive2d::Primitive2DContainer aSeq(3);
 197     B2DRectangle aBRect = vcl::unotools::b2DRectangleFromRectangle(aRect);
 198     B2DPolygon aPolygon = createPolygonFromRect(aBRect, 3.0 / BUTTON_WIDTH, 3.0 / BUTTON_HEIGHT);
 199
 200     // Create the polygon primitives
 201     aSeq[0].set(new drawinglayer::primitive2d::PolyPolygonColorPrimitive2D(
 202                                         B2DPolyPolygon(aPolygon), aOtherColor));
 203     aSeq[1].set(new drawinglayer::primitive2d::PolygonHairlinePrimitive2D(
 204                                         std::move(aPolygon), aColor));
 205
 206     // Create the primitive for the image
 207     BitmapEx aBmpEx(RID_BMP_PAGE_BREAK);
 208     double nImgOfstX = 3.0;
 209     if (bRtl)
 210         nImgOfstX = aRect.Right() - aBmpEx.GetSizePixel().Width() - 3.0;
 211     aSeq[2].set(new drawinglayer::primitive2d::DiscreteBitmapPrimitive2D(
 212                                         aBmpEx, B2DPoint(nImgOfstX, 1.0)));
 213
 214     double nTop = double(aRect.getOpenHeight()) / 2.0;
 215     double nBottom = nTop + 4.0;
 216     double nLeft = aRect.getOpenWidth() - ARROW_WIDTH - 6.0;
 217     if (bRtl)
 218         nLeft = ARROW_WIDTH - 2.0;
 219     double nRight = nLeft + 8.0;
 220
 221     B2DPolygon aTriangle;
 222     aTriangle.append(B2DPoint(nLeft, nTop));
 223     aTriangle.append(B2DPoint(nRight, nTop));
 224     aTriangle.append(B2DPoint((nLeft + nRight) / 2.0, nBottom));
 225     aTriangle.setClosed(true);
 226
 227     BColor aTriangleColor = COL_BLACK.getBColor();
 228     if (Application::GetSettings().GetStyleSettings().GetHighContrastMode())
 229         aTriangleColor = COL_WHITE.getBColor();
 230
 231     aSeq.emplace_back();
 232     aSeq.back().set( new drawinglayer::primitive2d::PolyPolygonColorPrimitive2D(
 233                                         B2DPolyPolygon(aTriangle), aTriangleColor));
 234
 235     drawinglayer::primitive2d::Primitive2DContainer aGhostedSeq(1);
 236     double nFadeRate = double(m_nFadeRate) / 100.0;
 237     const basegfx::BColorModifierSharedPtr aBColorModifier =
 238                 std::make_shared<basegfx::BColorModifier_interpolate>(COL_WHITE.getBColor(),
 239                                                         1.0 - nFadeRate);
 240     aGhostedSeq[0].set( new drawinglayer::primitive2d::ModifiedColorPrimitive2D(
 241                             std::move(aSeq), aBColorModifier));
 242
 243     // Create the processor and process the primitives
 244     const drawinglayer::geometry::ViewInformation2D aNewViewInfos;
 245     std::unique_ptr<drawinglayer::processor2d::BaseProcessor2D> pProcessor(
 246         drawinglayer::processor2d::createProcessor2DFromOutputDevice(*m_xVirDev, aNewViewInfos));
 247
 248     pProcessor->process(aGhostedSeq);
 249
 250     m_xMenuButton->set_custom_button(m_xVirDev.get());
 251 }
 252
 253 static SvxBreak lcl_GetBreakItem(const SwContentFrame* pCnt)
 254 {
 255     SvxBreak eBreak = SvxBreak::NONE;
 256     if ( pCnt )
 257     {
 258         if ( pCnt->IsInTab() )
 259             eBreak =  pCnt->FindTabFrame()->GetBreakItem().GetBreak();
 260         else
 261             eBreak = pCnt->GetBreakItem().GetBreak();
 262     }
 263     return eBreak;
 264 }
 265
 266 IMPL_LINK(SwPageBreakWin, SelectHdl, const OUString&, rIdent, void)
 267 {
 268     SwFrameControlPtr pFrameControl = m_pEditWin->GetFrameControlsManager().GetControl(FrameControlType::PageBreak, m_pFrame);
 269
 270     m_pLine->execute(rIdent);
 271
 272     // Only fade if there is more than this temporary shared pointer:
 273     // The main reference has been deleted due to a page break removal
 274     if (pFrameControl.use_count() > 1)
 275         Fade( false );
 276 }
 277
 278 void SwBreakDashedLine::execute(std::u16string_view rIdent)
 279 {
 280     const SwPageFrame* pPageFrame = SwFrameMenuButtonBase::GetPageFrame(m_pFrame);
 281     // Is there a PageBefore break on this page?
 282     SwContentFrame *pCnt = const_cast<SwContentFrame*>(pPageFrame->FindFirstBodyContent());
 283     SvxBreak eBreak = lcl_GetBreakItem( pCnt );
 284
 285     // Also check the previous page - to see if there is a PageAfter break
 286     SwContentFrame *pPrevCnt = nullptr;
 287     SvxBreak ePrevBreak = SvxBreak::NONE;
 288     const SwPageFrame* pPrevPage = static_cast<const SwPageFrame*>(pPageFrame->GetPrev());
 289     if ( pPrevPage )
 290     {
 291         pPrevCnt = const_cast<SwContentFrame*>(pPrevPage->FindLastBodyContent());
 292         ePrevBreak = lcl_GetBreakItem( pPrevCnt );
 293     }
 294
 295     if (pCnt && rIdent == u"edit")
 296     {
 297         SwWrtShell& rSh = m_pEditWin->GetView().GetWrtShell();
 298         bool bOldLock = rSh.IsViewLocked();
 299         rSh.LockView( true );
 300
 301         // Order of edit detection: first RES_BREAK PageAfter, then RES_BREAK PageBefore/RES_PAGEDESC
 302         if ( ePrevBreak == SvxBreak::PageAfter )
 303             pCnt = pPrevCnt;
 304
 305         SwContentNode& rNd = pCnt->IsTextFrame()
 306             ? *static_cast<SwTextFrame*>(pCnt)->GetTextNodeFirst()
 307             : *static_cast<SwNoTextFrame*>(pCnt)->GetNode();
 308
 309         if ( pCnt->IsInTab() )
 310         {
 311             rSh.Push( );
 312             rSh.ClearMark();
 313
 314             rSh.SetSelection( SwPaM(rNd) );
 315
 316             SfxStringItem aItem(m_pEditWin->GetView().GetPool().GetWhich(FN_FORMAT_TABLE_DLG), "textflow");
 317             m_pEditWin->GetView().GetViewFrame().GetDispatcher()->ExecuteList(
 318                     FN_FORMAT_TABLE_DLG,
 319                     SfxCallMode::SYNCHRON | SfxCallMode::RECORD,
 320                     { &aItem });
 321
 322             rSh.Pop(SwCursorShell::PopMode::DeleteCurrent);
 323         }
 324         else
 325         {
 326             SwPaM aPaM( rNd );
 327             SwPaMItem aPaMItem( m_pEditWin->GetView().GetPool( ).GetWhich( FN_PARAM_PAM ), &aPaM );
 328             SfxStringItem aItem( SID_PARA_DLG, "textflow" );
 329             m_pEditWin->GetView().GetViewFrame().GetDispatcher()->ExecuteList(
 330                     SID_PARA_DLG,
 331                     SfxCallMode::SYNCHRON | SfxCallMode::RECORD,
 332                     { &aItem, &aPaMItem });
 333         }
 334         rSh.LockView( bOldLock );
 335         m_pEditWin->GrabFocus( );
 336     }
 337     else if (pCnt && rIdent == u"delete")
 338     {
 339         SwContentNode& rNd = pCnt->IsTextFrame()
 340             ? *static_cast<SwTextFrame*>(pCnt)->GetTextNodeFirst()
 341             : *static_cast<SwNoTextFrame*>(pCnt)->GetNode();
 342
 343         rNd.GetDoc().GetIDocumentUndoRedo( ).StartUndo( SwUndoId::UI_DELETE_PAGE_BREAK, nullptr );
 344
 345         SfxItemSetFixed<RES_PAGEDESC, RES_BREAK> aSet(
 346             m_pEditWin->GetView().GetWrtShell().GetAttrPool());
 347
 348         aSet.Put( SwFormatPageDesc( nullptr ) );
 349         // This break could be from the current paragraph, if it has a PageBefore break.
 350         if ( eBreak == SvxBreak::PageBefore )
 351             aSet.Put( SvxFormatBreakItem( SvxBreak::NONE, RES_BREAK ) );
 352
 353         rNd.GetDoc().getIDocumentContentOperations().InsertItemSet(
 354             SwPaM(rNd), aSet, SetAttrMode::DEFAULT, pPageFrame->getRootFrame());
 355
 356         // This break could be from the previous paragraph, if it has a PageAfter break.
 357         if ( ePrevBreak == SvxBreak::PageAfter )
 358         {
 359             SwContentNode& rPrevNd = pPrevCnt->IsTextFrame()
 360                 ? *static_cast<SwTextFrame*>(pPrevCnt)->GetTextNodeFirst()
 361                 : *static_cast<SwNoTextFrame*>(pPrevCnt)->GetNode();
 362             aSet.ClearItem();
 363             aSet.Put( SvxFormatBreakItem( SvxBreak::NONE, RES_BREAK ) );
 364             rPrevNd.GetDoc().getIDocumentContentOperations().InsertItemSet(
 365                 SwPaM(rPrevNd), aSet, SetAttrMode::DEFAULT, pPrevCnt->getRootFrame());
 366         }
 367
 368         rNd.GetDoc().GetIDocumentUndoRedo( ).EndUndo( SwUndoId::UI_DELETE_PAGE_BREAK, nullptr );
 369     }
 370 }
 371
 372 void SwBreakDashedLine::UpdatePosition(const std::optional<Point>& xEvtPt)
 373 {
 374     if ( xEvtPt )
 375     {
 376         if ( xEvtPt == m_xMousePt )
 377             return;
 378         m_xMousePt = xEvtPt;
 379     }
 380
 381     const SwPageFrame* pPageFrame = SwFrameMenuButtonBase::GetPageFrame(m_pFrame);
 382     const SwFrame* pPrevPage = pPageFrame;
 383     do
 384     {
 385         pPrevPage = pPrevPage->GetPrev();
 386     }
 387     while ( pPrevPage && ( ( pPrevPage->getFrameArea().Top( ) == pPageFrame->getFrameArea().Top( ) )
 388                 || static_cast< const SwPageFrame* >( pPrevPage )->IsEmptyPage( ) ) );
 389
 390     ::tools::Rectangle aBoundRect = GetEditWin()->LogicToPixel( pPageFrame->GetBoundRect(GetEditWin()->GetOutDev()).SVRect() );
 391     ::tools::Rectangle aFrameRect = GetEditWin()->LogicToPixel( pPageFrame->getFrameArea().SVRect() );
 392
 393     tools::Long nYLineOffset = ( aBoundRect.Top() + aFrameRect.Top() ) / 2;
 394     if ( pPrevPage )
 395     {
 396         ::tools::Rectangle aPrevFrameRect = GetEditWin()->LogicToPixel( pPrevPage->getFrameArea().SVRect() );
 397         nYLineOffset = ( aPrevFrameRect.Bottom() + aFrameRect.Top() ) / 2;
 398     }
 399
 400     // Get the page + sidebar coords
 401     tools::Long nPgLeft = aFrameRect.Left();
 402     tools::Long nPgRight = aFrameRect.Right();
 403
 404     tools::ULong nSidebarWidth = 0;
 405     const SwPostItMgr* pPostItMngr = GetEditWin()->GetView().GetWrtShell().GetPostItMgr();
 406     if ( pPostItMngr && pPostItMngr->HasNotes() && pPostItMngr->ShowNotes() )
 407         nSidebarWidth = pPostItMngr->GetSidebarBorderWidth( true ) + pPostItMngr->GetSidebarWidth( true );
 408
 409     if ( pPageFrame->SidebarPosition( ) == sw::sidebarwindows::SidebarPosition::LEFT )
 410         nPgLeft -= nSidebarWidth;
 411     else if ( pPageFrame->SidebarPosition( ) == sw::sidebarwindows::SidebarPosition::RIGHT )
 412         nPgRight += nSidebarWidth;
 413
 414     Size aBtnSize( BUTTON_WIDTH + ARROW_WIDTH, BUTTON_HEIGHT );
 415
 416     // Place the button on the left or right?
 417     ::tools::Rectangle aVisArea = GetEditWin()->LogicToPixel( GetEditWin()->GetView().GetVisArea() );
 418
 419     tools::Long nLineLeft = std::max( nPgLeft, aVisArea.Left() );
 420     tools::Long nLineRight = std::min( nPgRight, aVisArea.Right() );
 421     tools::Long nBtnLeft = nLineLeft;
 422
 423     if ( m_xMousePt )
 424     {
 425         nBtnLeft = nLineLeft + m_xMousePt->X() - aBtnSize.getWidth() / 2;
 426
 427         if ( nBtnLeft < nLineLeft )
 428             nBtnLeft = nLineLeft;
 429         else if ( ( nBtnLeft + aBtnSize.getWidth() ) > nLineRight )
 430             nBtnLeft = nLineRight - aBtnSize.getWidth();
 431     }
 432
 433     // Set the button position
 434     m_aBtnRect = ::tools::Rectangle(Point(nBtnLeft, nYLineOffset - BUTTON_HEIGHT / 2), aBtnSize);
 435     if (m_pWin)
 436         m_pWin->SetRectanglePixel(m_aBtnRect);
 437
 438     // Set the line position
 439     Point aLinePos( nLineLeft, nYLineOffset - 5 );
 440     Size aLineSize( nLineRight - nLineLeft, 10 );
 441     SetPosSizePixel(aLinePos, aLineSize);
 442 }
 443
 444 void SwPageBreakWin::SetRectanglePixel(const ::tools::Rectangle& rRect)
 445 {
 446     SetPosSizePixel(rRect.TopLeft(), rRect.GetSize());
 447     m_xVirDev->SetOutputSizePixel(rRect.GetSize());
 448 }
 449
 450 void SwPageBreakWin::Fade( bool bFadeIn )
 451 {
 452     m_bIsAppearing = bFadeIn;
 453     if ( bFadeIn )
 454         m_nDelayAppearing = 0;
 455
 456     if ( !m_bDestroyed && m_aFadeTimer.IsActive( ) )
 457         m_aFadeTimer.Stop();
 458     if ( !m_bDestroyed )
 459         m_aFadeTimer.Start( );
 460 }
 461
 462 IMPL_LINK(SwPageBreakWin, ToggleHdl, weld::Toggleable&, rMenuButton, void)
 463 {
 464     // hide on dropdown, draw fully unfaded if dropdown before fully faded in
 465     Fade(rMenuButton.get_active());
 466 }
 467
 468 IMPL_LINK_NOARG(SwPageBreakWin, FadeHandler, Timer *, void)
 469 {
 470     const int TICKS_BEFORE_WE_APPEAR = 10;
 471     if ( m_bIsAppearing && m_nDelayAppearing < TICKS_BEFORE_WE_APPEAR )
 472     {
 473         ++m_nDelayAppearing;
 474         m_aFadeTimer.Start();
 475         return;
 476     }
 477
 478     if ( m_bIsAppearing && m_nFadeRate > 0 )
 479         m_nFadeRate -= 25;
 480     else if ( !m_bIsAppearing && m_nFadeRate < 100 )
 481         m_nFadeRate += 25;
 482
 483     if ( m_nFadeRate != 100 && !IsVisible() )
 484         Show();
 485     else if ( m_nFadeRate == 100 && IsVisible( ) )
 486     {
 487         Hide();
 488         m_pLine->DestroyWin();
 489         return;
 490     }
 491     else
 492     {
 493         m_pLine->UpdatePosition();
 494         PaintButton();
 495     }
 496
 497     if (IsVisible( ) && m_nFadeRate > 0 && m_nFadeRate < 100)
 498         m_aFadeTimer.Start();
 499 }
 500
 501 FactoryFunction SwBreakDashedLine::GetUITestFactory() const
 502 {
 503     return PageBreakUIObject::create;
 504 }
 505
 506 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */