sd/source/ui/tools/EventMultiplexer.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  * This file incorporates work covered by the following license notice:
  10  *
  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 .
  18  */
  19
  20 #include <EventMultiplexer.hxx>
  21
  22 #include <MutexOwner.hxx>
  23 #include <ViewShellBase.hxx>
  24 #include <drawdoc.hxx>
  25 #include <DrawController.hxx>
  26 #include <SlideSorterViewShell.hxx>
  27 #include <framework/FrameworkHelper.hxx>
  28 #include <sal/log.hxx>
  29 #include <tools/debug.hxx>
  30
  31 #include <com/sun/star/beans/XPropertySet.hpp>
  32 #include <com/sun/star/frame/XFrame.hpp>
  33 #include <com/sun/star/lang/DisposedException.hpp>
  34 #include <com/sun/star/drawing/framework/XConfigurationChangeListener.hpp>
  35 #include <com/sun/star/drawing/framework/XView.hpp>
  36 #include <cppuhelper/weak.hxx>
  37 #include <cppuhelper/compbase.hxx>
  38 #include <sfx2/viewfrm.hxx>
  39
  40 using namespace ::com::sun::star;
  41 using namespace ::com::sun::star::lang;
  42 using namespace ::com::sun::star::uno;
  43 using namespace ::com::sun::star::drawing::framework;
  44
  45 using ::sd::framework::FrameworkHelper;
  46
  47 class SdDrawDocument;
  48
  49 namespace {
  50 static const sal_Int32 ResourceActivationEvent = 0;
  51 static const sal_Int32 ResourceDeactivationEvent = 1;
  52 static const sal_Int32 ConfigurationUpdateEvent = 2;
  53 }
  54
  55 namespace sd { namespace tools {
  56
  57 typedef cppu::WeakComponentImplHelper<
  58       css::beans::XPropertyChangeListener,
  59       css::frame::XFrameActionListener,
  60       css::view::XSelectionChangeListener,
  61       css::drawing::framework::XConfigurationChangeListener
  62     > EventMultiplexerImplementationInterfaceBase;
  63
  64 class EventMultiplexer::Implementation
  65     : protected MutexOwner,
  66       public EventMultiplexerImplementationInterfaceBase,
  67       public SfxListener
  68 {
  69 public:
  70     explicit Implementation (ViewShellBase& rBase);
  71     virtual ~Implementation() override;
  72
  73     void AddEventListener (
  74         const Link<EventMultiplexerEvent&,void>& rCallback);
  75
  76     void RemoveEventListener (
  77         const Link<EventMultiplexerEvent&,void>& rCallback);
  78
  79     void CallListeners (EventMultiplexerEvent& rEvent);
  80
  81     //===== lang::XEventListener ==============================================
  82     virtual void SAL_CALL
  83         disposing (const css::lang::EventObject& rEventObject) override;
  84
  85     //===== beans::XPropertySetListener =======================================
  86     virtual void SAL_CALL
  87         propertyChange (
  88             const css::beans::PropertyChangeEvent& rEvent) override;
  89
  90     //===== view::XSelectionChangeListener ====================================
  91     virtual void SAL_CALL
  92         selectionChanged (
  93             const css::lang::EventObject& rEvent) override;
  94
  95     //===== frame::XFrameActionListener  ======================================
  96     /** For certain actions the listener connects to a new controller of the
  97         frame it is listening to.  This usually happens when the view shell
  98         in the center pane is replaced by another view shell.
  99     */
 100     virtual void SAL_CALL
 101         frameAction (const css::frame::FrameActionEvent& rEvent) override;
 102
 103     //===== drawing::framework::XConfigurationChangeListener ==================
 104     virtual void SAL_CALL
 105         notifyConfigurationChange (
 106             const css::drawing::framework::ConfigurationChangeEvent& rEvent) override;
 107
 108     virtual void SAL_CALL disposing() override;
 109
 110 protected:
 111     virtual void Notify (
 112         SfxBroadcaster& rBroadcaster,
 113         const SfxHint& rHint) override;
 114
 115 private:
 116     ViewShellBase& mrBase;
 117     typedef ::std::vector<Link<EventMultiplexerEvent&,void>> ListenerList;
 118     ListenerList maListeners;
 119
 120     /// Remember whether we are listening to the UNO controller.
 121     bool mbListeningToController;
 122     /// Remember whether we are listening to the frame.
 123     bool mbListeningToFrame;
 124
 125     css::uno::WeakReference<css::frame::XController> mxControllerWeak;
 126     css::uno::WeakReference<css::frame::XFrame> mxFrameWeak;
 127     SdDrawDocument* mpDocument;
 128     css::uno::WeakReference<css::drawing::framework::XConfigurationController>
 129          mxConfigurationControllerWeak;
 130
 131     void ReleaseListeners();
 132
 133     void ConnectToController();
 134     void DisconnectFromController();
 135
 136     void CallListeners (
 137         EventMultiplexerEventId eId,
 138         void const * pUserData = nullptr);
 139
 140     DECL_LINK(SlideSorterSelectionChangeListener, LinkParamNone*, void);
 141 };
 142
 143 const char aCurrentPagePropertyName[] = "CurrentPage";
 144 const char aEditModePropertyName[] = "IsMasterPageMode";
 145
 146 //===== EventMultiplexer ======================================================
 147
 148 EventMultiplexer::EventMultiplexer (ViewShellBase& rBase)
 149     : mpImpl (new EventMultiplexer::Implementation(rBase))
 150 {
 151 }
 152
 153 EventMultiplexer::~EventMultiplexer()
 154 {
 155     try
 156     {
 157         mpImpl->dispose();
 158     }
 159     catch (const RuntimeException&)
 160     {
 161     }
 162     catch (const Exception&)
 163     {
 164     }
 165 }
 166
 167 void EventMultiplexer::AddEventListener (
 168     const Link<EventMultiplexerEvent&,void>& rCallback)
 169 {
 170     mpImpl->AddEventListener(rCallback);
 171 }
 172
 173 void EventMultiplexer::RemoveEventListener (
 174     const Link<EventMultiplexerEvent&,void>& rCallback)
 175 {
 176     mpImpl->RemoveEventListener(rCallback);
 177 }
 178
 179 void EventMultiplexer::MultiplexEvent(
 180     EventMultiplexerEventId eEventId,
 181     void const * pUserData )
 182 {
 183     EventMultiplexerEvent aEvent(eEventId, pUserData);
 184     mpImpl->CallListeners(aEvent);
 185 }
 186
 187 //===== EventMultiplexer::Implementation ======================================
 188
 189 EventMultiplexer::Implementation::Implementation (ViewShellBase& rBase)
 190     : MutexOwner(),
 191       EventMultiplexerImplementationInterfaceBase(maMutex),
 192       SfxListener(),
 193       mrBase (rBase),
 194       mbListeningToController (false),
 195       mbListeningToFrame (false),
 196       mxControllerWeak(nullptr),
 197       mxFrameWeak(nullptr),
 198       mpDocument(nullptr),
 199       mxConfigurationControllerWeak()
 200 {
 201     // Connect to the frame to listen for controllers being exchanged.
 202     // Listen to changes of certain properties.
 203     Reference<frame::XFrame> xFrame (
 204         mrBase.GetFrame()->GetFrame().GetFrameInterface(),
 205         uno::UNO_QUERY);
 206     mxFrameWeak = xFrame;
 207     if (xFrame.is())
 208     {
 209         xFrame->addFrameActionListener (
 210             Reference<frame::XFrameActionListener>(
 211                static_cast<XWeak*>(this), UNO_QUERY));
 212         mbListeningToFrame = true;
 213     }
 214
 215     // Connect to the current controller.
 216     ConnectToController ();
 217
 218     // Listen for document changes.
 219     mpDocument = mrBase.GetDocument();
 220     if (mpDocument != nullptr)
 221         StartListening (*mpDocument);
 222
 223     // Listen for configuration changes.
 224     Reference<XControllerManager> xControllerManager (
 225         Reference<XWeak>(&mrBase.GetDrawController()), UNO_QUERY);
 226     if (!xControllerManager.is())
 227         return;
 228
 229     Reference<XConfigurationController> xConfigurationController (
 230         xControllerManager->getConfigurationController());
 231     mxConfigurationControllerWeak = xConfigurationController;
 232     if (!xConfigurationController.is())
 233         return;
 234
 235     Reference<XComponent> xComponent (xConfigurationController, UNO_QUERY);
 236     if (xComponent.is())
 237         xComponent->addEventListener(static_cast<beans::XPropertyChangeListener*>(this));
 238
 239     xConfigurationController->addConfigurationChangeListener(
 240         this,
 241         FrameworkHelper::msResourceActivationEvent,
 242         makeAny(ResourceActivationEvent));
 243     xConfigurationController->addConfigurationChangeListener(
 244         this,
 245         FrameworkHelper::msResourceDeactivationEvent,
 246         makeAny(ResourceDeactivationEvent));
 247     xConfigurationController->addConfigurationChangeListener(
 248         this,
 249         FrameworkHelper::msConfigurationUpdateEndEvent,
 250         makeAny(ConfigurationUpdateEvent));
 251 }
 252
 253 EventMultiplexer::Implementation::~Implementation()
 254 {
 255     DBG_ASSERT( !mbListeningToFrame,
 256         "sd::EventMultiplexer::Implementation::~Implementation(), disposing was not called!" );
 257 }
 258
 259 void EventMultiplexer::Implementation::ReleaseListeners()
 260 {
 261     if (mbListeningToFrame)
 262     {
 263         mbListeningToFrame = false;
 264
 265         // Stop listening for changes of certain properties.
 266         Reference<frame::XFrame> xFrame (mxFrameWeak);
 267         if (xFrame.is())
 268         {
 269             xFrame->removeFrameActionListener (
 270                 Reference<frame::XFrameActionListener>(
 271                     static_cast<XWeak*>(this), UNO_QUERY));
 272         }
 273     }
 274
 275     DisconnectFromController ();
 276
 277     if (mpDocument != nullptr)
 278     {
 279         EndListening (*mpDocument);
 280         mpDocument = nullptr;
 281     }
 282
 283     // Stop listening for configuration changes.
 284     Reference<XConfigurationController> xConfigurationController (mxConfigurationControllerWeak);
 285     if (xConfigurationController.is())
 286     {
 287         Reference<XComponent> xComponent (xConfigurationController, UNO_QUERY);
 288         if (xComponent.is())
 289             xComponent->removeEventListener(static_cast<beans::XPropertyChangeListener*>(this));
 290
 291         xConfigurationController->removeConfigurationChangeListener(this);
 292     }
 293 }
 294
 295 void EventMultiplexer::Implementation::AddEventListener (
 296     const Link<EventMultiplexerEvent&,void>& rCallback)
 297 {
 298     for (auto const & i : maListeners)
 299         if (i == rCallback)
 300             return;
 301     maListeners.push_back(rCallback);
 302 }
 303
 304 void EventMultiplexer::Implementation::RemoveEventListener (
 305     const Link<EventMultiplexerEvent&,void>& rCallback)
 306 {
 307     auto iListener = std::find(maListeners.begin(), maListeners.end(), rCallback);
 308     if (iListener != maListeners.end())
 309         maListeners.erase(iListener);
 310 }
 311
 312 void EventMultiplexer::Implementation::ConnectToController()
 313 {
 314     // Just in case that we missed some event we now disconnect from the old
 315     // controller.
 316     DisconnectFromController ();
 317
 318     // Register at the controller of the main view shell.
 319
 320     // We have to store a (weak) reference to the controller so that we can
 321     // unregister without having to ask the mrBase member (which at that
 322     // time may be destroyed.)
 323     Reference<frame::XController> xController = mrBase.GetController();
 324     mxControllerWeak = mrBase.GetController();
 325
 326     try
 327     {
 328         // Listen for disposing events.
 329         Reference<lang::XComponent> xComponent (xController, UNO_QUERY);
 330         if (xComponent.is())
 331         {
 332             xComponent->addEventListener (
 333                 Reference<lang::XEventListener>(
 334                     static_cast<XWeak*>(this), UNO_QUERY));
 335             mbListeningToController = true;
 336         }
 337
 338         // Listen to changes of certain properties.
 339         Reference<beans::XPropertySet> xSet (xController, UNO_QUERY);
 340         if (xSet.is())
 341         {
 342                 try
 343                 {
 344                     xSet->addPropertyChangeListener(aCurrentPagePropertyName, this);
 345                 }
 346                 catch (const beans::UnknownPropertyException&)
 347                 {
 348                     SAL_WARN("sd", "EventMultiplexer::ConnectToController: CurrentPage unknown");
 349                 }
 350
 351                 try
 352                 {
 353                     xSet->addPropertyChangeListener(aEditModePropertyName, this);
 354                 }
 355                 catch (const beans::UnknownPropertyException&)
 356                 {
 357                     SAL_WARN("sd", "EventMultiplexer::ConnectToController: IsMasterPageMode unknown");
 358                 }
 359         }
 360
 361         // Listen for selection change events.
 362         Reference<view::XSelectionSupplier> xSelection (xController, UNO_QUERY);
 363         if (xSelection.is())
 364         {
 365             xSelection->addSelectionChangeListener(this);
 366         }
 367     }
 368     catch (const lang::DisposedException&)
 369     {
 370         mbListeningToController = false;
 371     }
 372 }
 373
 374 void EventMultiplexer::Implementation::DisconnectFromController()
 375 {
 376     if (!mbListeningToController)
 377         return;
 378
 379     mbListeningToController = false;
 380
 381     Reference<frame::XController> xController = mxControllerWeak;
 382
 383     Reference<beans::XPropertySet> xSet (xController, UNO_QUERY);
 384     // Remove the property listener.
 385     if (xSet.is())
 386     {
 387         try
 388         {
 389             xSet->removePropertyChangeListener(aCurrentPagePropertyName, this);
 390         }
 391         catch (const beans::UnknownPropertyException&)
 392         {
 393             SAL_WARN("sd", "DisconnectFromController: CurrentPage unknown");
 394         }
 395
 396         try
 397         {
 398             xSet->removePropertyChangeListener(aEditModePropertyName, this);
 399         }
 400         catch (const beans::UnknownPropertyException&)
 401         {
 402             SAL_WARN("sd", "DisconnectFromController: IsMasterPageMode unknown");
 403         }
 404     }
 405
 406     // Remove selection change listener.
 407     Reference<view::XSelectionSupplier> xSelection (xController, UNO_QUERY);
 408     if (xSelection.is())
 409     {
 410         xSelection->removeSelectionChangeListener(this);
 411     }
 412
 413     // Remove listener for disposing events.
 414     Reference<lang::XComponent> xComponent (xController, UNO_QUERY);
 415     if (xComponent.is())
 416     {
 417         xComponent->removeEventListener (
 418             Reference<lang::XEventListener>(static_cast<XWeak*>(this), UNO_QUERY));
 419     }
 420 }
 421
 422 //=====  lang::XEventListener  ================================================
 423
 424 void SAL_CALL EventMultiplexer::Implementation::disposing (
 425     const lang::EventObject& rEventObject)
 426 {
 427     if (mbListeningToController)
 428     {
 429         Reference<frame::XController> xController (mxControllerWeak);
 430         if (rEventObject.Source == xController)
 431         {
 432             mbListeningToController = false;
 433         }
 434     }
 435
 436     Reference<XConfigurationController> xConfigurationController (
 437         mxConfigurationControllerWeak);
 438     if (xConfigurationController.is()
 439         && rEventObject.Source == xConfigurationController)
 440     {
 441         mxConfigurationControllerWeak.clear();
 442     }
 443 }
 444
 445 //=====  beans::XPropertySetListener  =========================================
 446
 447 void SAL_CALL EventMultiplexer::Implementation::propertyChange (
 448     const beans::PropertyChangeEvent& rEvent)
 449 {
 450     if (rBHelper.bDisposed || rBHelper.bInDispose)
 451     {
 452         throw lang::DisposedException (
 453             "SlideSorterController object has already been disposed",
 454             static_cast<uno::XWeak*>(this));
 455     }
 456
 457     if ( rEvent.PropertyName == aCurrentPagePropertyName )
 458     {
 459         CallListeners(EventMultiplexerEventId::CurrentPageChanged);
 460     }
 461     else if ( rEvent.PropertyName == aEditModePropertyName )
 462     {
 463         bool bIsMasterPageMode (false);
 464         rEvent.NewValue >>= bIsMasterPageMode;
 465         if (bIsMasterPageMode)
 466             CallListeners(EventMultiplexerEventId::EditModeMaster);
 467         else
 468             CallListeners(EventMultiplexerEventId::EditModeNormal);
 469     }
 470 }
 471
 472 //===== frame::XFrameActionListener  ==========================================
 473
 474 void SAL_CALL EventMultiplexer::Implementation::frameAction (
 475     const frame::FrameActionEvent& rEvent)
 476 {
 477     Reference<frame::XFrame> xFrame (mxFrameWeak);
 478     if (rEvent.Frame != xFrame)
 479         return;
 480
 481     switch (rEvent.Action)
 482     {
 483         case frame::FrameAction_COMPONENT_DETACHING:
 484             DisconnectFromController();
 485             CallListeners (EventMultiplexerEventId::ControllerDetached);
 486             break;
 487
 488         case frame::FrameAction_COMPONENT_REATTACHED:
 489             CallListeners (EventMultiplexerEventId::ControllerDetached);
 490             DisconnectFromController();
 491             ConnectToController();
 492             CallListeners (EventMultiplexerEventId::ControllerAttached);
 493             break;
 494
 495         case frame::FrameAction_COMPONENT_ATTACHED:
 496             ConnectToController();
 497             CallListeners (EventMultiplexerEventId::ControllerAttached);
 498             break;
 499
 500         default:
 501             break;
 502     }
 503 }
 504
 505 //===== view::XSelectionChangeListener ========================================
 506
 507 void SAL_CALL EventMultiplexer::Implementation::selectionChanged (
 508     const lang::EventObject& )
 509 {
 510     CallListeners (EventMultiplexerEventId::EditViewSelection);
 511 }
 512
 513 //===== drawing::framework::XConfigurationChangeListener ==================
 514
 515 void SAL_CALL EventMultiplexer::Implementation::notifyConfigurationChange (
 516     const ConfigurationChangeEvent& rEvent)
 517 {
 518     sal_Int32 nEventType = 0;
 519     rEvent.UserData >>= nEventType;
 520     switch (nEventType)
 521     {
 522         case ResourceActivationEvent:
 523             if (rEvent.ResourceId->getResourceURL().match(FrameworkHelper::msViewURLPrefix))
 524             {
 525                 CallListeners (EventMultiplexerEventId::ViewAdded);
 526
 527                 if (rEvent.ResourceId->isBoundToURL(
 528                     FrameworkHelper::msCenterPaneURL, AnchorBindingMode_DIRECT))
 529                 {
 530                     CallListeners (EventMultiplexerEventId::MainViewAdded);
 531                 }
 532
 533                 // Add selection change listener at slide sorter.
 534                 if (rEvent.ResourceId->getResourceURL() == FrameworkHelper::msSlideSorterURL)
 535                 {
 536                     slidesorter::SlideSorterViewShell* pViewShell
 537                         = dynamic_cast<slidesorter::SlideSorterViewShell*>(
 538                             FrameworkHelper::GetViewShell(
 539                                 Reference<XView>(rEvent.ResourceObject,UNO_QUERY)).get());
 540                     if (pViewShell != nullptr)
 541                         pViewShell->AddSelectionChangeListener (
 542                             LINK(this,
 543                                 EventMultiplexer::Implementation,
 544                                 SlideSorterSelectionChangeListener));
 545                 }
 546             }
 547             break;
 548
 549         case ResourceDeactivationEvent:
 550             if (rEvent.ResourceId->getResourceURL().match(FrameworkHelper::msViewURLPrefix))
 551             {
 552                 if (rEvent.ResourceId->isBoundToURL(
 553                     FrameworkHelper::msCenterPaneURL, AnchorBindingMode_DIRECT))
 554                 {
 555                     CallListeners (EventMultiplexerEventId::MainViewRemoved);
 556                 }
 557
 558                 // Remove selection change listener from slide sorter.  Add
 559                 // selection change listener at slide sorter.
 560                 if (rEvent.ResourceId->getResourceURL() == FrameworkHelper::msSlideSorterURL)
 561                 {
 562                     slidesorter::SlideSorterViewShell* pViewShell
 563                         = dynamic_cast<slidesorter::SlideSorterViewShell*>(
 564                             FrameworkHelper::GetViewShell(
 565                                 Reference<XView>(rEvent.ResourceObject, UNO_QUERY)).get());
 566                     if (pViewShell != nullptr)
 567                         pViewShell->RemoveSelectionChangeListener (
 568                             LINK(this,
 569                                 EventMultiplexer::Implementation,
 570                                 SlideSorterSelectionChangeListener));
 571                 }
 572             }
 573             break;
 574
 575         case ConfigurationUpdateEvent:
 576             CallListeners (EventMultiplexerEventId::ConfigurationUpdated);
 577             break;
 578     }
 579
 580 }
 581
 582 void SAL_CALL EventMultiplexer::Implementation::disposing()
 583 {
 584     CallListeners (EventMultiplexerEventId::Disposing);
 585     ReleaseListeners();
 586 }
 587
 588 void EventMultiplexer::Implementation::Notify (
 589     SfxBroadcaster&,
 590     const SfxHint& rHint)
 591 {
 592     if (rHint.GetId() == SfxHintId::ThisIsAnSdrHint)
 593     {
 594         const SdrHint* pSdrHint = static_cast<const SdrHint*>(&rHint);
 595         switch (pSdrHint->GetKind())
 596         {
 597             case SdrHintKind::ModelCleared:
 598             case SdrHintKind::PageOrderChange:
 599                 CallListeners (EventMultiplexerEventId::PageOrder);
 600                 break;
 601
 602             case SdrHintKind::SwitchToPage:
 603                 CallListeners (EventMultiplexerEventId::CurrentPageChanged);
 604                 break;
 605
 606             case SdrHintKind::ObjectChange:
 607                 CallListeners(EventMultiplexerEventId::ShapeChanged,
 608                     static_cast<const void*>(pSdrHint->GetPage()));
 609                 break;
 610
 611             case SdrHintKind::ObjectInserted:
 612                 CallListeners(EventMultiplexerEventId::ShapeInserted,
 613                     static_cast<const void*>(pSdrHint->GetPage()));
 614                 break;
 615
 616             case SdrHintKind::ObjectRemoved:
 617                 CallListeners(EventMultiplexerEventId::ShapeRemoved,
 618                     static_cast<const void*>(pSdrHint->GetPage()));
 619                 break;
 620             default:
 621                 break;
 622         }
 623     }
 624     else
 625     {
 626         if (rHint.GetId() == SfxHintId::Dying)
 627             mpDocument = nullptr;
 628     }
 629 }
 630
 631 void EventMultiplexer::Implementation::CallListeners (
 632     EventMultiplexerEventId eId,
 633     void const * pUserData)
 634 {
 635     EventMultiplexerEvent aEvent(eId, pUserData);
 636     CallListeners(aEvent);
 637 }
 638
 639 void EventMultiplexer::Implementation::CallListeners (EventMultiplexerEvent& rEvent)
 640 {
 641     ListenerList aCopyListeners( maListeners );
 642     for (auto& rListener : aCopyListeners)
 643     {
 644         rListener.Call(rEvent);
 645     }
 646 }
 647
 648 IMPL_LINK_NOARG(EventMultiplexer::Implementation, SlideSorterSelectionChangeListener, LinkParamNone*, void)
 649 {
 650     CallListeners(EventMultiplexerEventId::SlideSortedSelection);
 651 }
 652
 653 //===== EventMultiplexerEvent =================================================
 654
 655 EventMultiplexerEvent::EventMultiplexerEvent (
 656     EventMultiplexerEventId eEventId,
 657     const void* pUserData)
 658     : meEventId(eEventId),
 659       mpUserData(pUserData)
 660 {
 661 }
 662
 663 } } // end of namespace ::sd::tools
 664
 665 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */