How do I use wxSplitterWindow? (wxWidgets)
Author
I found the overview on the official documentation unclear. Example code would also be appreciated.
Well here's the splitter.cpp example I got with the Dev-C++ package. I'm not sure if it comes with the other downloads, you might already have it, but it's probably the best you'll find. Unfortunately with wxWidgets, the documentation examples are too simple and the source examples are too complex [smile].
/////////////////////////////////////////////////////////////////////////////// Name: splitter.cpp// Purpose: wxSplitterWindow sample// Author: Julian Smart// Modified by:// Created: 04/01/98// RCS-ID: $Id: splitter.cpp,v 1.24 2005/03/30 15:36:15 JS Exp $// Copyright: (c) Julian Smart// Licence: wxWindows license/////////////////////////////////////////////////////////////////////////////// ============================================================================// declarations// ============================================================================// ----------------------------------------------------------------------------// headers// ----------------------------------------------------------------------------// For compilers that support precompilation, includes "wx/wx.h".#include "wx/wxprec.h"#ifdef __BORLANDC__ #pragma hdrstop#endif#ifndef WX_PRECOMP #include "wx/log.h" #include "wx/app.h" #include "wx/frame.h" #include "wx/scrolwin.h" #include "wx/menu.h" #include "wx/textdlg.h" // for wxGetTextFromUser#endif#include "wx/splitter.h"#include "wx/dcmirror.h"// ----------------------------------------------------------------------------// constants// ----------------------------------------------------------------------------// ID for the menu commandsenum{ SPLIT_QUIT = 1, SPLIT_HORIZONTAL, SPLIT_VERTICAL, SPLIT_UNSPLIT, SPLIT_LIVE, SPLIT_SETPOSITION, SPLIT_SETMINSIZE, SPLIT_SETGRAVITY, SPLIT_REPLACE};// ----------------------------------------------------------------------------// our classes// ----------------------------------------------------------------------------class MyApp: public wxApp{public: MyApp() { } virtual bool OnInit(); DECLARE_NO_COPY_CLASS(MyApp)};class MyFrame: public wxFrame{public: MyFrame(); virtual ~MyFrame(); // Menu commands void SplitHorizontal(wxCommandEvent& event); void SplitVertical(wxCommandEvent& event); void Unsplit(wxCommandEvent& event); void ToggleLive(wxCommandEvent& event); void SetPosition(wxCommandEvent& event); void SetMinSize(wxCommandEvent& event); void SetGravity(wxCommandEvent& event); void Replace(wxCommandEvent &event); void Quit(wxCommandEvent& event); // Menu command update functions void UpdateUIHorizontal(wxUpdateUIEvent& event); void UpdateUIVertical(wxUpdateUIEvent& event); void UpdateUIUnsplit(wxUpdateUIEvent& event);private: wxScrolledWindow *m_left, *m_right; wxSplitterWindow* m_splitter; wxWindow *m_replacewindow; DECLARE_EVENT_TABLE() DECLARE_NO_COPY_CLASS(MyFrame)};class MySplitterWindow : public wxSplitterWindow{public: MySplitterWindow(wxFrame *parent); // event handlers void OnPositionChanged(wxSplitterEvent& event); void OnPositionChanging(wxSplitterEvent& event); void OnDClick(wxSplitterEvent& event); void OnUnsplitEvent(wxSplitterEvent& event);private: wxFrame *m_frame; DECLARE_EVENT_TABLE() DECLARE_NO_COPY_CLASS(MySplitterWindow)};class MyCanvas: public wxScrolledWindow{public: MyCanvas(wxWindow* parent, bool mirror); virtual ~MyCanvas(){}; virtual void OnDraw(wxDC& dc);private: bool m_mirror; DECLARE_NO_COPY_CLASS(MyCanvas)};// ============================================================================// implementation// ============================================================================// ----------------------------------------------------------------------------// MyApp// ----------------------------------------------------------------------------IMPLEMENT_APP(MyApp)bool MyApp::OnInit(){ // create and show the main frame MyFrame* frame = new MyFrame; frame->Show(true); return true;}// ----------------------------------------------------------------------------// MyFrame// ----------------------------------------------------------------------------BEGIN_EVENT_TABLE(MyFrame, wxFrame) EVT_MENU(SPLIT_VERTICAL, MyFrame::SplitVertical) EVT_MENU(SPLIT_HORIZONTAL, MyFrame::SplitHorizontal) EVT_MENU(SPLIT_UNSPLIT, MyFrame::Unsplit) EVT_MENU(SPLIT_LIVE, MyFrame::ToggleLive) EVT_MENU(SPLIT_SETPOSITION, MyFrame::SetPosition) EVT_MENU(SPLIT_SETMINSIZE, MyFrame::SetMinSize) EVT_MENU(SPLIT_SETGRAVITY, MyFrame::SetGravity) EVT_MENU(SPLIT_REPLACE, MyFrame::Replace) EVT_MENU(SPLIT_QUIT, MyFrame::Quit) EVT_UPDATE_UI(SPLIT_VERTICAL, MyFrame::UpdateUIVertical) EVT_UPDATE_UI(SPLIT_HORIZONTAL, MyFrame::UpdateUIHorizontal) EVT_UPDATE_UI(SPLIT_UNSPLIT, MyFrame::UpdateUIUnsplit)END_EVENT_TABLE()// My frame constructorMyFrame::MyFrame() : wxFrame(NULL, wxID_ANY, _T("wxSplitterWindow sample"), wxDefaultPosition, wxSize(420, 300), wxDEFAULT_FRAME_STYLE | wxNO_FULL_REPAINT_ON_RESIZE){#if wxUSE_STATUSBAR CreateStatusBar(2);#endif // wxUSE_STATUSBAR // Make a menubar wxMenu *splitMenu = new wxMenu; splitMenu->Append(SPLIT_VERTICAL, _T("Split &Vertically\tCtrl-V"), _T("Split vertically")); splitMenu->Append(SPLIT_HORIZONTAL, _T("Split &Horizontally\tCtrl-H"), _T("Split horizontally")); splitMenu->Append(SPLIT_UNSPLIT, _T("&Unsplit\tCtrl-U"), _T("Unsplit")); splitMenu->AppendSeparator(); splitMenu->AppendCheckItem(SPLIT_LIVE, _T("&Live update\tCtrl-L"), _T("Toggle live update mode")); splitMenu->Append(SPLIT_SETPOSITION, _T("Set splitter &position\tCtrl-P"), _T("Set the splitter position")); splitMenu->Append(SPLIT_SETMINSIZE, _T("Set &min size\tCtrl-M"), _T("Set minimum pane size")); splitMenu->Append(SPLIT_SETGRAVITY, _T("Set &gravity\tCtrl-G"), _T("Set gravity of sash")); splitMenu->AppendSeparator(); splitMenu->Append(SPLIT_REPLACE, _T("&Replace right window"), _T("Replace right window")); splitMenu->AppendSeparator(); splitMenu->Append(SPLIT_QUIT, _T("E&xit\tAlt-X"), _T("Exit")); wxMenuBar *menuBar = new wxMenuBar; menuBar->Append(splitMenu, _T("&Splitter")); SetMenuBar(menuBar); menuBar->Check(SPLIT_LIVE, true); m_splitter = new MySplitterWindow(this); m_splitter->SetSashGravity(1.0);#if 1 m_left = new MyCanvas(m_splitter, true); m_left->SetBackgroundColour(*wxRED); m_left->SetScrollbars(20, 20, 5, 5); m_left->SetCursor(wxCursor(wxCURSOR_MAGNIFIER)); m_right = new MyCanvas(m_splitter, false); m_right->SetBackgroundColour(*wxCYAN); m_right->SetScrollbars(20, 20, 5, 5);#else // for testing kbd navigation inside the splitter m_left = new wxTextCtrl(m_splitter, wxID_ANY, _T("first text")); m_right = new wxTextCtrl(m_splitter, wxID_ANY, _T("second text"));#endif // you can also do this to start with a single window#if 0 m_right->Show(false); m_splitter->Initialize(m_left);#else // you can also try -100 m_splitter->SplitVertically(m_left, m_right, 100);#endif#if wxUSE_STATUSBAR SetStatusText(_T("Min pane size = 0"), 1);#endif // wxUSE_STATUSBAR m_replacewindow = (wxWindow *)0;}MyFrame::~MyFrame(){ if (m_replacewindow) { m_replacewindow->Destroy(); m_replacewindow = (wxWindow *)0; }}// menu command handlersvoid MyFrame::Quit(wxCommandEvent& WXUNUSED(event) ){ Close(true);}void MyFrame::SplitHorizontal(wxCommandEvent& WXUNUSED(event) ){ if ( m_splitter->IsSplit() ) m_splitter->Unsplit(); m_left->Show(true); m_right->Show(true); m_splitter->SplitHorizontally( m_left, m_right );#if wxUSE_STATUSBAR SetStatusText(_T("Splitter split horizontally"), 1);#endif // wxUSE_STATUSBAR}void MyFrame::SplitVertical(wxCommandEvent& WXUNUSED(event) ){ if ( m_splitter->IsSplit() ) m_splitter->Unsplit(); m_left->Show(true); m_right->Show(true); m_splitter->SplitVertically( m_left, m_right );#if wxUSE_STATUSBAR SetStatusText(_T("Splitter split vertically"), 1);#endif // wxUSE_STATUSBAR}void MyFrame::Unsplit(wxCommandEvent& WXUNUSED(event) ){ if ( m_splitter->IsSplit() ) m_splitter->Unsplit();#if wxUSE_STATUSBAR SetStatusText(_T("No splitter"));#endif // wxUSE_STATUSBAR}void MyFrame::ToggleLive(wxCommandEvent& event ){ long style = m_splitter->GetWindowStyleFlag(); if ( event.IsChecked() ) style |= wxSP_LIVE_UPDATE; else style &= ~wxSP_LIVE_UPDATE; m_splitter->SetWindowStyleFlag(style);}void MyFrame::SetPosition(wxCommandEvent& WXUNUSED(event) ){ wxString str; str.Printf( wxT("%d"), m_splitter->GetSashPosition()); str = wxGetTextFromUser(_T("Enter splitter position:"), _T(""), str, this); if ( str.empty() ) return; long pos; if ( !str.ToLong(&pos) ) { wxLogError(_T("The splitter position should be an integer.")); return; } m_splitter->SetSashPosition(pos); wxLogStatus(this, _T("Splitter position set to %ld"), pos);}void MyFrame::SetMinSize(wxCommandEvent& WXUNUSED(event) ){ wxString str; str.Printf( wxT("%d"), m_splitter->GetMinimumPaneSize()); str = wxGetTextFromUser(_T("Enter minimal size for panes:"), _T(""), str, this); if ( str.empty() ) return; int minsize = wxStrtol( str, (wxChar**)NULL, 10 ); m_splitter->SetMinimumPaneSize(minsize);#if wxUSE_STATUSBAR str.Printf( wxT("Min pane size = %d"), minsize); SetStatusText(str, 1);#endif // wxUSE_STATUSBAR}void MyFrame::SetGravity(wxCommandEvent& WXUNUSED(event) ){ wxString str; str.Printf( wxT("%g"), m_splitter->GetSashGravity()); str = wxGetTextFromUser(_T("Enter sash gravity (0,1):"), _T(""), str, this); if ( str.empty() ) return; double gravity = wxStrtod( str, (wxChar**)NULL); m_splitter->SetSashGravity(gravity);#if wxUSE_STATUSBAR str.Printf( wxT("Gravity = %g"), gravity); SetStatusText(str, 1);#endif // wxUSE_STATUSBAR}void MyFrame::Replace(wxCommandEvent& WXUNUSED(event) ){ if (m_replacewindow == 0) { m_replacewindow = m_splitter->GetWindow2(); m_splitter->ReplaceWindow(m_replacewindow, new wxPanel(m_splitter, wxID_ANY)); m_replacewindow->Hide(); } else { wxWindow *empty = m_splitter->GetWindow2(); m_splitter->ReplaceWindow(empty, m_replacewindow); m_replacewindow->Show(); m_replacewindow = 0; empty->Destroy(); }}// Update UI handlersvoid MyFrame::UpdateUIHorizontal(wxUpdateUIEvent& event){ event.Enable( (!m_splitter->IsSplit()) || (m_splitter->GetSplitMode() != wxSPLIT_HORIZONTAL) );}void MyFrame::UpdateUIVertical(wxUpdateUIEvent& event){ event.Enable( ( (!m_splitter->IsSplit()) || (m_splitter->GetSplitMode() != wxSPLIT_VERTICAL) ) );}void MyFrame::UpdateUIUnsplit(wxUpdateUIEvent& event){ event.Enable( m_splitter->IsSplit() );}// ----------------------------------------------------------------------------// MySplitterWindow// ----------------------------------------------------------------------------BEGIN_EVENT_TABLE(MySplitterWindow, wxSplitterWindow) EVT_SPLITTER_SASH_POS_CHANGED(wxID_ANY, MySplitterWindow::OnPositionChanged) EVT_SPLITTER_SASH_POS_CHANGING(wxID_ANY, MySplitterWindow::OnPositionChanging) EVT_SPLITTER_DCLICK(wxID_ANY, MySplitterWindow::OnDClick) EVT_SPLITTER_UNSPLIT(wxID_ANY, MySplitterWindow::OnUnsplitEvent)END_EVENT_TABLE()MySplitterWindow::MySplitterWindow(wxFrame *parent) : wxSplitterWindow(parent, wxID_ANY, wxDefaultPosition, wxDefaultSize, wxSP_3D | wxSP_LIVE_UPDATE | wxCLIP_CHILDREN /* | wxSP_NO_XP_THEME */ ){ m_frame = parent;}void MySplitterWindow::OnPositionChanged(wxSplitterEvent& event){ wxLogStatus(m_frame, _T("Position has changed, now = %d (or %d)"), event.GetSashPosition(), GetSashPosition()); event.Skip();}void MySplitterWindow::OnPositionChanging(wxSplitterEvent& event){ wxLogStatus(m_frame, _T("Position is changing, now = %d (or %d)"), event.GetSashPosition(), GetSashPosition()); event.Skip();}void MySplitterWindow::OnDClick(wxSplitterEvent& event){#if wxUSE_STATUSBAR m_frame->SetStatusText(_T("Splitter double clicked"), 1);#endif // wxUSE_STATUSBAR event.Skip();}void MySplitterWindow::OnUnsplitEvent(wxSplitterEvent& event){#if wxUSE_STATUSBAR m_frame->SetStatusText(_T("Splitter unsplit"), 1);#endif // wxUSE_STATUSBAR event.Skip();}// ----------------------------------------------------------------------------// MyCanvas// ----------------------------------------------------------------------------MyCanvas::MyCanvas(wxWindow* parent, bool mirror) : wxScrolledWindow(parent, wxID_ANY, wxDefaultPosition, wxDefaultSize, wxHSCROLL | wxVSCROLL | wxNO_FULL_REPAINT_ON_RESIZE){ m_mirror = mirror;}void MyCanvas::OnDraw(wxDC& dcOrig){ wxMirrorDC dc(dcOrig, m_mirror); dc.SetPen(*wxBLACK_PEN); dc.DrawLine(0, 0, 100, 200); dc.SetBackgroundMode(wxTRANSPARENT); dc.DrawText(_T("Testing"), 50, 50); dc.SetPen(*wxRED_PEN); dc.SetBrush(*wxGREEN_BRUSH); dc.DrawRectangle(120, 120, 100, 80);}
wxSplitterWindow *splitter = new wxSplitterWindow(parent_window);
then
splitter->SplitHorizontally(top_window, bottom_window);
or
splitter->SplitVertically(left_window, right_window);
then
splitter->SplitHorizontally(top_window, bottom_window);
or
splitter->SplitVertically(left_window, right_window);
Also another couple important functions for a splitter window..
// sets the size of the left window (if split vertically)splitter->SetSashPosition(100); // sets the absolute value of the size of the right window (if split vert)splitter->SetSashPosition(-100);// sets the sashsize so you cannot resize the splitssplitter->SetSashSize(0);This topic is closed to new replies.
Advertisement
Popular Topics
Advertisement