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(u"PageBreak"_ustr); // 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, u"modules/swriter/ui/pbmenubutton.ui"_ustr, u"PBMenuButton"_ustr),
 127     m_xMenuButton(m_xBuilder->weld_menu_button(u"menubutton"_ustr)),
 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;
 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.push_back(new drawinglayer::primitive2d::PolyPolygonColorPrimitive2D(
 202                                         B2DPolyPolygon(aPolygon), aOtherColor));
 203     aSeq.push_back(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.push_back(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.push_back( new drawinglayer::primitive2d::PolyPolygonColorPrimitive2D(
 232                                         B2DPolyPolygon(aTriangle), aTriangleColor));
 233
 234     drawinglayer::primitive2d::Primitive2DContainer aGhostedSeq;
 235     double nFadeRate = double(m_nFadeRate) / 100.0;
 236     const basegfx::BColorModifierSharedPtr aBColorModifier =
 237                 std::make_shared<basegfx::BColorModifier_interpolate>(COL_WHITE.getBColor(),
 238                                                         1.0 - nFadeRate);
 239     aGhostedSeq.push_back( new drawinglayer::primitive2d::ModifiedColorPrimitive2D(
 240                             std::move(aSeq), aBColorModifier));
 241
 242     // Create the processor and process the primitives
 243     const drawinglayer::geometry::ViewInformation2D aNewViewInfos;
 244     std::unique_ptr<drawinglayer::processor2d::BaseProcessor2D> pProcessor(
 245         drawinglayer::processor2d::createProcessor2DFromOutputDevice(*m_xVirDev, aNewViewInfos));
 246
 247     pProcessor->process(aGhostedSeq);
 248
 249     m_xMenuButton->set_custom_button(m_xVirDev.get());
 250 }
 251
 252 static SvxBreak lcl_GetBreakItem(const SwContentFrame* pCnt)
 253 {
 254     SvxBreak eBreak = SvxBreak::NONE;
 255     if ( pCnt )
 256     {
 257         if ( pCnt->IsInTab() )
 258             eBreak =  pCnt->FindTabFrame()->GetBreakItem().GetBreak();
 259         else
 260             eBreak = pCnt->GetBreakItem().GetBreak();
 261     }
 262     return eBreak;
 263 }
 264
 265 IMPL_LINK(SwPageBreakWin, SelectHdl, const OUString&, rIdent, void)
 266 {
 267     SwFrameControlPtr pFrameControl = m_pEditWin->GetFrameControlsManager().GetControl(FrameControlType::PageBreak, m_pFrame);
 268
 269     m_pLine->execute(rIdent);
 270
 271     // Only fade if there is more than this temporary shared pointer:
 272     // The main reference has been deleted due to a page break removal
 273     if (pFrameControl.use_count() > 1)
 274         Fade( false );
 275 }
 276
 277 void SwBreakDashedLine::execute(std::u16string_view rIdent)
 278 {
 279     const SwPageFrame* pPageFrame = SwFrameMenuButtonBase::GetPageFrame(m_pFrame);
 280     // Is there a PageBefore break on this page?
 281     SwContentFrame *pCnt = const_cast<SwContentFrame*>(pPageFrame->FindFirstBodyContent());
 282     SvxBreak eBreak = lcl_GetBreakItem( pCnt );
 283
 284     // Also check the previous page - to see if there is a PageAfter break
 285     SwContentFrame *pPrevCnt = nullptr;
 286     SvxBreak ePrevBreak = SvxBreak::NONE;
 287     const SwPageFrame* pPrevPage = static_cast<const SwPageFrame*>(pPageFrame->GetPrev());
 288     if ( pPrevPage )
 289     {
 290         pPrevCnt = const_cast<SwContentFrame*>(pPrevPage->FindLastBodyContent());
 291         ePrevBreak = lcl_GetBreakItem( pPrevCnt );
 292     }
 293
 294     if (pCnt && rIdent == u"edit")
 295     {
 296         SwWrtShell& rSh = m_pEditWin->GetView().GetWrtShell();
 297         bool bOldLock = rSh.IsViewLocked();
 298         rSh.LockView( true );
 299
 300         // Order of edit detection: first RES_BREAK PageAfter, then RES_BREAK PageBefore/RES_PAGEDESC
 301         if ( ePrevBreak == SvxBreak::PageAfter )
 302             pCnt = pPrevCnt;
 303
 304         SwContentNode& rNd = pCnt->IsTextFrame()
 305             ? *static_cast<SwTextFrame*>(pCnt)->GetTextNodeFirst()
 306             : *static_cast<SwNoTextFrame*>(pCnt)->GetNode();
 307
 308         if ( pCnt->IsInTab() )
 309         {
 310             rSh.Push( );
 311             rSh.ClearMark();
 312
 313             rSh.SetSelection( SwPaM(rNd) );
 314
 315             SfxStringItem aItem(m_pEditWin->GetView().GetPool().GetWhichIDFromSlotID(FN_FORMAT_TABLE_DLG), u"textflow"_ustr);
 316             m_pEditWin->GetView().GetViewFrame().GetDispatcher()->ExecuteList(
 317                     FN_FORMAT_TABLE_DLG,
 318                     SfxCallMode::SYNCHRON | SfxCallMode::RECORD,
 319                     { &aItem });
 320
 321             rSh.Pop(SwCursorShell::PopMode::DeleteCurrent);
 322         }
 323         else
 324         {
 325             SwPaM aPaM( rNd );
 326             SwPaMItem aPaMItem( m_pEditWin->GetView().GetPool( ).GetWhichIDFromSlotID( FN_PARAM_PAM ), &aPaM );
 327             SfxStringItem aItem( SID_PARA_DLG, u"textflow"_ustr );
 328             m_pEditWin->GetView().GetViewFrame().GetDispatcher()->ExecuteList(
 329                     SID_PARA_DLG,
 330                     SfxCallMode::SYNCHRON | SfxCallMode::RECORD,
 331                     { &aItem, &aPaMItem });
 332         }
 333         rSh.LockView( bOldLock );
 334         m_pEditWin->GrabFocus( );
 335     }
 336     else if (pCnt && rIdent == u"delete")
 337     {
 338         SwContentNode& rNd = pCnt->IsTextFrame()
 339             ? *static_cast<SwTextFrame*>(pCnt)->GetTextNodeFirst()
 340             : *static_cast<SwNoTextFrame*>(pCnt)->GetNode();
 341
 342         rNd.GetDoc().GetIDocumentUndoRedo( ).StartUndo( SwUndoId::UI_DELETE_PAGE_BREAK, nullptr );
 343
 344         SfxItemSetFixed<RES_PAGEDESC, RES_BREAK> aSet(
 345             m_pEditWin->GetView().GetWrtShell().GetAttrPool());
 346
 347         aSet.Put( SwFormatPageDesc( nullptr ) );
 348         // This break could be from the current paragraph, if it has a PageBefore break.
 349         if ( eBreak == SvxBreak::PageBefore )
 350             aSet.Put( SvxFormatBreakItem( SvxBreak::NONE, RES_BREAK ) );
 351
 352         rNd.GetDoc().getIDocumentContentOperations().InsertItemSet(
 353             SwPaM(rNd), aSet, SetAttrMode::DEFAULT, pPageFrame->getRootFrame());
 354
 355         // This break could be from the previous paragraph, if it has a PageAfter break.
 356         if ( ePrevBreak == SvxBreak::PageAfter )
 357         {
 358             SwContentNode& rPrevNd = pPrevCnt->IsTextFrame()
 359                 ? *static_cast<SwTextFrame*>(pPrevCnt)->GetTextNodeFirst()
 360                 : *static_cast<SwNoTextFrame*>(pPrevCnt)->GetNode();
 361             aSet.ClearItem();
 362             aSet.Put( SvxFormatBreakItem( SvxBreak::NONE, RES_BREAK ) );
 363             rPrevNd.GetDoc().getIDocumentContentOperations().InsertItemSet(
 364                 SwPaM(rPrevNd), aSet, SetAttrMode::DEFAULT, pPrevCnt->getRootFrame());
 365         }
 366
 367         rNd.GetDoc().GetIDocumentUndoRedo( ).EndUndo( SwUndoId::UI_DELETE_PAGE_BREAK, nullptr );
 368     }
 369 }
 370
 371 void SwBreakDashedLine::UpdatePosition(const std::optional<Point>& xEvtPt)
 372 {
 373     if ( xEvtPt )
 374     {
 375         if ( xEvtPt == m_xMousePt )
 376             return;
 377         m_xMousePt = xEvtPt;
 378     }
 379
 380     const SwPageFrame* pPageFrame = SwFrameMenuButtonBase::GetPageFrame(m_pFrame);
 381     const SwFrame* pPrevPage = pPageFrame;
 382     do
 383     {
 384         pPrevPage = pPrevPage->GetPrev();
 385     }
 386     while ( pPrevPage && ( ( pPrevPage->getFrameArea().Top( ) == pPageFrame->getFrameArea().Top( ) )
 387                 || static_cast< const SwPageFrame* >( pPrevPage )->IsEmptyPage( ) ) );
 388
 389     ::tools::Rectangle aBoundRect = GetEditWin()->LogicToPixel( pPageFrame->GetBoundRect(GetEditWin()->GetOutDev()).SVRect() );
 390     ::tools::Rectangle aFrameRect = GetEditWin()->LogicToPixel( pPageFrame->getFrameArea().SVRect() );
 391
 392     tools::Long nYLineOffset = ( aBoundRect.Top() + aFrameRect.Top() ) / 2;
 393     if ( pPrevPage )
 394     {
 395         ::tools::Rectangle aPrevFrameRect = GetEditWin()->LogicToPixel( pPrevPage->getFrameArea().SVRect() );
 396         nYLineOffset = ( aPrevFrameRect.Bottom() + aFrameRect.Top() ) / 2;
 397     }
 398
 399     // Get the page + sidebar coords
 400     tools::Long nPgLeft = aFrameRect.Left();
 401     tools::Long nPgRight = aFrameRect.Right();
 402
 403     tools::ULong nSidebarWidth = 0;
 404     const SwPostItMgr* pPostItMngr = GetEditWin()->GetView().GetWrtShell().GetPostItMgr();
 405     if ( pPostItMngr && pPostItMngr->HasNotes() && pPostItMngr->ShowNotes() )
 406         nSidebarWidth = pPostItMngr->GetSidebarBorderWidth( true ) + pPostItMngr->GetSidebarWidth( true );
 407
 408     if ( pPageFrame->SidebarPosition( ) == sw::sidebarwindows::SidebarPosition::LEFT )
 409         nPgLeft -= nSidebarWidth;
 410     else if ( pPageFrame->SidebarPosition( ) == sw::sidebarwindows::SidebarPosition::RIGHT )
 411         nPgRight += nSidebarWidth;
 412
 413     Size aBtnSize( BUTTON_WIDTH + ARROW_WIDTH, BUTTON_HEIGHT );
 414
 415     // Place the button on the left or right?
 416     ::tools::Rectangle aVisArea = GetEditWin()->LogicToPixel( GetEditWin()->GetView().GetVisArea() );
 417
 418     tools::Long nLineLeft = std::max( nPgLeft, aVisArea.Left() );
 419     tools::Long nLineRight = std::min( nPgRight, aVisArea.Right() );
 420     tools::Long nBtnLeft = nLineLeft;
 421
 422     if ( m_xMousePt )
 423     {
 424         nBtnLeft = nLineLeft + m_xMousePt->X() - aBtnSize.getWidth() / 2;
 425
 426         if ( nBtnLeft < nLineLeft )
 427             nBtnLeft = nLineLeft;
 428         else if ( ( nBtnLeft + aBtnSize.getWidth() ) > nLineRight )
 429             nBtnLeft = nLineRight - aBtnSize.getWidth();
 430     }
 431
 432     // Set the button position
 433     m_aBtnRect = ::tools::Rectangle(Point(nBtnLeft, nYLineOffset - BUTTON_HEIGHT / 2), aBtnSize);
 434     if (m_pWin)
 435         m_pWin->SetRectanglePixel(m_aBtnRect);
 436
 437     // Set the line position
 438     Point aLinePos( nLineLeft, nYLineOffset - 5 );
 439     Size aLineSize( nLineRight - nLineLeft, 10 );
 440     SetPosSizePixel(aLinePos, aLineSize);
 441 }
 442
 443 void SwPageBreakWin::SetRectanglePixel(const ::tools::Rectangle& rRect)
 444 {
 445     SetPosSizePixel(rRect.TopLeft(), rRect.GetSize());
 446     m_xVirDev->SetOutputSizePixel(rRect.GetSize());
 447 }
 448
 449 void SwPageBreakWin::Fade( bool bFadeIn )
 450 {
 451     m_bIsAppearing = bFadeIn;
 452     if ( bFadeIn )
 453         m_nDelayAppearing = 0;
 454
 455     if ( !m_bDestroyed && m_aFadeTimer.IsActive( ) )
 456         m_aFadeTimer.Stop();
 457     if ( !m_bDestroyed )
 458         m_aFadeTimer.Start( );
 459 }
 460
 461 IMPL_LINK(SwPageBreakWin, ToggleHdl, weld::Toggleable&, rMenuButton, void)
 462 {
 463     // hide on dropdown, draw fully unfaded if dropdown before fully faded in
 464     Fade(rMenuButton.get_active());
 465 }
 466
 467 IMPL_LINK_NOARG(SwPageBreakWin, FadeHandler, Timer *, void)
 468 {
 469     const int TICKS_BEFORE_WE_APPEAR = 10;
 470     if ( m_bIsAppearing && m_nDelayAppearing < TICKS_BEFORE_WE_APPEAR )
 471     {
 472         ++m_nDelayAppearing;
 473         m_aFadeTimer.Start();
 474         return;
 475     }
 476
 477     if ( m_bIsAppearing && m_nFadeRate > 0 )
 478         m_nFadeRate -= 25;
 479     else if ( !m_bIsAppearing && m_nFadeRate < 100 )
 480         m_nFadeRate += 25;
 481
 482     if ( m_nFadeRate != 100 && !IsVisible() )
 483         Show();
 484     else if ( m_nFadeRate == 100 && IsVisible( ) )
 485     {
 486         Hide();
 487         m_pLine->DestroyWin();
 488         return;
 489     }
 490     else
 491     {
 492         m_pLine->UpdatePosition();
 493         PaintButton();
 494     }
 495
 496     if (IsVisible( ) && m_nFadeRate > 0 && m_nFadeRate < 100)
 497         m_aFadeTimer.Start();
 498 }
 499
 500 FactoryFunction SwBreakDashedLine::GetUITestFactory() const
 501 {
 502     return PageBreakUIObject::create;
 503 }
 504
 505 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */