TGDockableFrame.cxx

Go to the documentation of this file.

// @(#)root/gui:$Id$
// Author: Abdelhalim Ssadik   07/07/04
 
/*************************************************************************
 * Copyright (C) 1995-2004, Rene Brun and Fons Rademakers.               *
 * All rights reserved.                                                  *
 *                                                                       *
 * For the licensing terms see $ROOTSYS/LICENSE.                         *
 * For the list of contributors see $ROOTSYS/README/CREDITS.             *
 *************************************************************************/
/**************************************************************************
 
    This source is based on Xclass95, a Win95-looking GUI toolkit.
    Copyright (C) 1996, 1997 David Barth, Ricky Ralston, Hector Peraza.
 
    Xclass95 is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.
 
**************************************************************************/
 
 
/** \class TGDockableFrame
    \ingroup guiwidgets
 
A frame with handles that allow it to be
undocked (i.e. put in a transient frame of its own) and to be docked
again or hidden and shown again. It uses the TGDockButton, which is
a button with two vertical bars (||) and TGDockHideButton, which is
a button with a small triangle. The TGUndockedFrame is a transient
frame that on closure will put the frame back in the dock.
 
*/
 
 
#include "TColor.h"
#include "TGFrame.h"
#include "TGWidget.h"
#include "TGButton.h"
#include "TGDockableFrame.h"
#include "TGWindow.h"
#include "TList.h"
#include "TVirtualX.h"
 
#include <iostream>
 
 
ClassImp(TGDockButton);
ClassImp(TGDockHideButton);
ClassImp(TGUndockedFrame);
ClassImp(TGDockableFrame);
 
////////////////////////////////////////////////////////////////////////////////
/// Create a dock button (i.e. button with two vertical bars).
 
TGDockButton::TGDockButton(const TGCompositeFrame *p, int id) :
   TGButton (p, id, GetDefaultGC()(), kChildFrame)
{
   fWidgetFlags = kWidgetIsEnabled;
   fMouseOn = kFALSE;
   Resize(10, GetDefaultHeight());
 
   fNormBg = fBackground;
 
   Float_t r, g, b, h, l, s;
   TColor::Pixel2RGB(fNormBg, r, g, b);
   TColor::RGB2HLS(r, g, b, h, l, s);
   l = l + (1. - l) * 45. / 100.;
   TColor::HLS2RGB(h, l, s, r, g, b);
   fHiBg = TColor::RGB2Pixel(r, g, b);
 
   AddInput(kEnterWindowMask | kLeaveWindowMask);
   SetWindowName();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Delete dock button.
 
TGDockButton::~TGDockButton()
{
}
 
////////////////////////////////////////////////////////////////////////////////
/// Handle dock button crossing events.
 
Bool_t TGDockButton::HandleCrossing(Event_t *event)
{
   TGButton::HandleCrossing(event);
   if (event->fType == kLeaveNotify) {
      fMouseOn = kFALSE;
   } else if (event->fType == kEnterNotify) {
      fMouseOn = kTRUE;
   }
   if (IsEnabled())
      fClient->NeedRedraw(this);
 
   return kTRUE;
}
 
////////////////////////////////////////////////////////////////////////////////
/// Draw borders of dock button.
 
void TGDockButton::DrawBorder()
{
   int options = GetOptions();
 
   if (fState == kButtonDown || fState == kButtonEngaged)
      ;
   else if (fMouseOn == kTRUE && IsEnabled()) {
      SetBackgroundColor(fHiBg);
      ChangeOptions(kChildFrame);
   } else {
      SetBackgroundColor(fNormBg);
      ChangeOptions(kChildFrame);
   }
   gVirtualX->ClearWindow(fId);
   TGFrame::DrawBorder();
 
   ChangeOptions(options);
}
 
////////////////////////////////////////////////////////////////////////////////
/// Draw the dock button, i.e. two vertical lines.
 
void TGDockButton::DoRedraw()
{
   int x = 1, y = 0;
 
   DrawBorder();
   if (fState == kButtonDown || fState == kButtonEngaged) { ++x; ++y; }
 
   for (int i = 0; i < 5; i +=4) {
      gVirtualX->DrawLine(fId, GetHilightGC()(), i+x,   y+1, i+x,   fHeight-y-3);
      gVirtualX->DrawLine(fId, GetShadowGC()(),  i+x+1, y+1, i+x+1, fHeight-y-3);
   }
}
 
 
////////////////////////////////////////////////////////////////////////////////
/// Create a dock hide button (i.e. button with small triangle).
 
TGDockHideButton::TGDockHideButton(const TGCompositeFrame *p) :
   TGDockButton (p, 2)
{
   Resize(10, 8);
   fAspectRatio = 0;
   SetWindowName();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Draw dock hide button.
 
void TGDockHideButton::DoRedraw()
{
   int x = 1, y = 0;
 
   DrawBorder();
   if (fState == kButtonDown || fState == kButtonEngaged) { ++x; ++y; }
 
   if (fAspectRatio) {
      gVirtualX->DrawLine(fId, GetBlackGC()(), x+1, y+1, x+5, y+3);
      gVirtualX->DrawLine(fId, GetBlackGC()(), x+1, y+5, x+5, y+3);
      gVirtualX->DrawLine(fId, GetHilightGC()(), x, y+1, x, y+5);
   } else {
      gVirtualX->DrawLine(fId, GetHilightGC()(), x+5, y+1, x+1, y+3);
      gVirtualX->DrawLine(fId, GetHilightGC()(), x+5, y+5, x+1, y+3);
      gVirtualX->DrawLine(fId, GetBlackGC()(), x+6, y+1, x+6, y+5);
   }
}
 
 
////////////////////////////////////////////////////////////////////////////////
/// Create the undocked (transient) frame.
 
TGUndockedFrame::TGUndockedFrame(const TGWindow *p, TGDockableFrame *dockable) :
   TGTransientFrame(p, dockable ? dockable->GetMainFrame() : 0, 10, 10)
{
   SetWindowName("");
   fDockable = dockable;
 
   SetMWMHints(kMWMDecorAll | kMWMDecorResizeH  | kMWMDecorMaximize |
                              kMWMDecorMinimize | kMWMDecorMenu,
               kMWMFuncAll  | kMWMFuncResize    | kMWMFuncMaximize |
                              kMWMFuncMinimize,
               kMWMInputModeless);
   SetWindowName();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Delete undocked frame. Puts back dockable frame in its original container.
 
TGUndockedFrame::~TGUndockedFrame()
{
   if (fDockable && !fDockable->fDeleted) {
      fDockable->DockContainer(kFALSE);
   }
}
 
////////////////////////////////////////////////////////////////////////////////
/// Fix the size of the undocked frame so it cannot be changed via the WM.
 
void TGUndockedFrame::FixSize()
{
   ChangeOptions(GetOptions() | kFixedSize);
   SetWMSize(fWidth, fHeight);
   SetWMSizeHints(fWidth, fHeight, fWidth, fHeight, 0, 0);
}
 
////////////////////////////////////////////////////////////////////////////////
/// Close undocked frame (called via WM close button).
 
void TGUndockedFrame::CloseWindow()
{
   DeleteWindow();
}
 
 
////////////////////////////////////////////////////////////////////////////////
/// Create a dockable frame widget.
 
TGDockableFrame::TGDockableFrame(const TGWindow *p, Int_t id, UInt_t /*options*/)
   : TGCompositeFrame(p, 10, 10, kHorizontalFrame), TGWidget(id)
{
   fMsgWindow = fParent;
 
   TGLayoutHints *l1 = new TGLayoutHints(kLHintsTop | kLHintsLeft);
   TGLayoutHints *l2 = new TGLayoutHints(kLHintsExpandY | kLHintsLeft);
   fLb = new TGLayoutHints(kLHintsExpandY | kLHintsLeft, 0, 2, 0, 0);
   fLc = new TGLayoutHints(kLHintsExpandY | kLHintsExpandX);
 
   fButtons = new TGCompositeFrame(this, 10, 10, kVerticalFrame);
   fButtons->SetCleanup();
   fHideButton = new TGDockHideButton(fButtons);
   fButtons->AddFrame(fHideButton, l1);
   fDockButton = new TGDockButton(fButtons);
   fButtons->AddFrame(fDockButton, l2);
 
   TGCompositeFrame::AddFrame(fButtons, fLb);
 
   fContainer = new TGCompositeFrame(this, 10, 10);
 
   TGCompositeFrame::AddFrame(fContainer, fLc);
 
   fEnableHide   = kTRUE;
   fEnableUndock = kTRUE;
   fHidden       = kFALSE;
   fFrame        = 0;
   fDeleted      = kFALSE;
   fFixedSize    = kTRUE;
 
   fDockButton->Associate(this);
   fHideButton->Associate(this);
 
   MapSubwindows();
   Resize(GetDefaultSize());
   TGFrame::SetWindowName();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Cleanup dockable frame.
 
TGDockableFrame::~TGDockableFrame()
{
   // Just set the flag and delete fFrame. The other components
   // are deleted in TGCompositeFrame destructor.
   if (fFrame) {
      fDeleted = kTRUE;
      delete fFrame;
   }
}
 
////////////////////////////////////////////////////////////////////////////////
/// Add frame to dockable frame container. Frame and hints are NOT adopted.
 
void TGDockableFrame::AddFrame(TGFrame *f, TGLayoutHints *hints)
{
   f->ReparentWindow(fContainer);
   fContainer->AddFrame(f, fHints = hints);
   fContainer->Layout();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Undock container.
 
void TGDockableFrame::UndockContainer()
{
   int ax, ay;
   Window_t wdummy;
 
   if (fFrame || !fEnableUndock) return;
 
   fFrame = new TGUndockedFrame(fClient->GetDefaultRoot(), this);
   fFrame->SetEditDisabled();
 
   TGDimension size = fContainer->GetSize();
   RemoveFrame(fContainer);
   fContainer->ReparentWindow(fFrame);
   fFrame->AddFrame(fContainer, new TGLayoutHints(kLHintsExpandY | kLHintsExpandX));
 
   gVirtualX->TranslateCoordinates(GetId(), fClient->GetDefaultRoot()->GetId(), fX,
                                   fY + fFrame->GetHeight(), ax, ay, wdummy);
 
   if (fDockName) fFrame->SetWindowName(fDockName);
 
   fFrame->MapSubwindows();
   fFrame->Resize(size);
   if (fFixedSize)
      fFrame->FixSize();
   fFrame->MapWindow();
   fFrame->Move(ax, ay);
 
   if (((TGFrame *)fParent)->IsComposite())           // paranoia check
      ((TGCompositeFrame *)fParent)->HideFrame(this);
 
   Layout();
 
   SendMessage(fMsgWindow, MK_MSG(kC_DOCK, kDOCK_UNDOCK), fWidgetId, 0);
   Undocked();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Dock container back to TGDockableFrame.
 
void TGDockableFrame::DockContainer(Int_t del)
{
   if (!fFrame) return;
   if (del) {
      delete fFrame;  // this will call DockContainer again with del = kFALSE
      return;
   }
 
   fFrame->RemoveFrame(fContainer);
   fContainer->ReparentWindow(this);
   TGCompositeFrame::AddFrame(fContainer, new TGLayoutHints(kLHintsExpandY | kLHintsExpandX));
 
   // kludge! (for special case)
   fDockButton->Resize(fDockButton->GetDefaultWidth(), 1);
 
   Layout();
   if (((TGFrame *)fParent)->IsComposite())           // paranoia check
      ((TGCompositeFrame *)fParent)->ShowFrame(this);
 
   // fFrame is just being deleted (we're here called by TGUndockedFrame's
   // destructor) so just set it NULL below to avoid eventual problems in
   // TGDockableFrame's destructor.
 
   fFrame = 0;
 
   SendMessage(fMsgWindow, MK_MSG(kC_DOCK, kDOCK_DOCK), fWidgetId, 0);
   Docked();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Show dock container.
 
void TGDockableFrame::ShowContainer()
{
   if (!fHidden) return;
 
   ShowFrame(fContainer);
   if (fEnableUndock) fButtons->ShowFrame(fDockButton);
   fHideButton->SetAspectRatio(0);
   if (((TGFrame *)fParent)->IsComposite())           // paranoia check
      ((TGCompositeFrame *)fParent)->Layout();
   fHidden = kFALSE;
 
   SendMessage(fMsgWindow, MK_MSG(kC_DOCK, kDOCK_SHOW), fWidgetId, 0);
}
 
////////////////////////////////////////////////////////////////////////////////
/// Hide dock container.
 
void TGDockableFrame::HideContainer()
{
   if (fHidden || !fEnableHide) return;
 
   HideFrame(fContainer);
   fButtons->HideFrame(fDockButton);
   fHideButton->SetAspectRatio(1);
   if (((TGFrame *)fParent)->IsComposite())           // paranoia check
      ((TGCompositeFrame *)fParent)->Layout();
   fHidden = kTRUE;
 
   SendMessage(fMsgWindow, MK_MSG(kC_DOCK, kDOCK_HIDE),fWidgetId, 0);
}
 
////////////////////////////////////////////////////////////////////////////////
/// Process dockable frame messages.
 
Bool_t TGDockableFrame::ProcessMessage(Longptr_t msg, Longptr_t parm1, Longptr_t)
{
   switch (GET_MSG(msg)) {
      case kC_COMMAND:
         switch (GET_SUBMSG(msg)) {
            case kCM_BUTTON:
               switch (parm1) {
                  case 1:
                     if (!fHidden) UndockContainer();
                     break;
                  case 2:
                     if (!fHidden)
                        HideContainer();
                     else
                        ShowContainer();
                     break;
               }
               break;
         }
         break;
   }
 
   return kTRUE;
}
 
////////////////////////////////////////////////////////////////////////////////
/// Enable undocking.
 
void TGDockableFrame::EnableUndock(Bool_t onoff)
{
   fEnableUndock = onoff;
   if (onoff)
      fButtons->ShowFrame(fDockButton);
   else
      fButtons->HideFrame(fDockButton);
   Layout();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Enable hiding.
 
void TGDockableFrame::EnableHide(Bool_t onoff)
{
   fEnableHide = onoff;
   if (onoff)
      fButtons->ShowFrame(fHideButton);
   else
      fButtons->HideFrame(fHideButton);
   Layout();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set window name so it appear as title of the undock window.
 
void TGDockableFrame::SetWindowName(const char *name)
{
   fDockName = "";
   if (name) {
      fDockName = name;
      if (fFrame) fFrame->SetWindowName(fDockName);
   }
}
 
////////////////////////////////////////////////////////////////////////////////
/// Save a dockable frame widget as a C++ statement(s) on output stream out.
 
void TGDockableFrame::SavePrimitive(std::ostream &out, Option_t *option /*= ""*/)
{
   out << "\n   // dockable frame\n";
   out << "   TGDockableFrame *" << GetName()<<" = new TGDockableFrame(" << fParent->GetName();
 
   if (GetOptions() == kHorizontalFrame) {
      if (fWidgetId == -1) {
         out << ");\n";
      } else {
         out << "," << fWidgetId << ");\n";
      }
   } else {
      out << "," << fWidgetId << "," << GetOptionString() << ");\n";
   }
   if (option && strstr(option, "keep_names"))
      out << "   " << GetName() << "->SetName(\"" << GetName() << "\");\n";
 
   if (GetContainer()->GetList()->First()) {
      out << "   TGCompositeFrame *" << GetContainer()->GetName() << " = "
          << GetName() << "->GetContainer();\n";
 
      TIter next(GetContainer()->GetList());
 
      while (auto el = (TGFrameElement *) next()) {
         el->fFrame->SavePrimitive(out, option);
         out << "   " << GetName() << "->AddFrame(" << el->fFrame->GetName();
         el->fLayout->SavePrimitive(out, option);
         out << ");\n";
      }
   }
   out << "\n   // next lines belong to the dockable frame widget\n";
   if (EnableUndock())
      out << "   " << GetName() << "->EnableUndock(kTRUE);\n";
   else
      out << "   " << GetName() << "->EnableUndock(kFALSE);\n";
 
   if (EnableHide())
      out << "   " << GetName() << "->EnableHide(kTRUE);\n";
   else
      out << "   " << GetName() << "->EnableHide(kFALSE);\n";
 
   if (fDockName.Length() > 0)
      out << "   " << GetName() << "->SetWindowName(\"" << TString(fDockName).ReplaceSpecialCppChars() << "\");\n";
 
   if (IsUndocked())
      out << "   " << GetName() << "->UndockContainer();\n";
   else
      out << "   " << GetName() << "->DockContainer();\n";
 
   if (IsHidden())
      out << "   " << GetName() << "->HideContainer();\n";
 
   out << "   \n";
}