1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: wxScrolledWindow sample
4 // Author: Robert Roebling
6 // Copyright: (C) 1998 Robert Roebling, 2002 Ron Lee, 2003 Matt Gregory
7 // (C) 2008 Vadim Zeitlin
8 // Licence: wxWindows license
9 /////////////////////////////////////////////////////////////////////////////
11 #include "wx/wxprec.h"
23 #include "wx/tglbtn.h"
25 // ----------------------------------------------------------------------------
27 // ----------------------------------------------------------------------------
29 // MySimpleCanvas: a scrolled window which draws a simple rectangle
30 class MySimpleCanvas
: public wxScrolledWindow
35 // these numbers are not multiple of 10 (our scroll step) to test for
36 // the absence of rounding errors (e.g. we should have one more page
37 // than WIDTH/10 to show the right side of the rectangle)
42 MySimpleCanvas(wxWindow
*parent
)
43 : wxScrolledWindow(parent
, wxID_ANY
)
45 SetScrollRate( 10, 10 );
46 SetVirtualSize( WIDTH
, HEIGHT
);
47 SetBackgroundColour( *wxWHITE
);
49 Connect(wxEVT_PAINT
, wxPaintEventHandler(MySimpleCanvas::OnPaint
));
53 void OnPaint(wxPaintEvent
& WXUNUSED(event
))
57 // this call is vital: it adjusts the dc to account for the current
61 dc
.SetPen( *wxRED_PEN
);
62 dc
.SetBrush( *wxTRANSPARENT_BRUSH
);
63 dc
.DrawRectangle( 0, 0, WIDTH
, HEIGHT
);
68 // MySimpleFrame: a frame which contains a MySimpleCanvas
69 class MySimpleFrame
: public wxFrame
72 MySimpleFrame(wxWindow
*parent
)
73 : wxFrame(parent
, wxID_ANY
, "MySimpleCanvas")
75 new MySimpleCanvas(this);
77 // ensure that we have scrollbars initially
78 SetClientSize(MySimpleCanvas::WIDTH
/2, MySimpleCanvas::HEIGHT
/2);
84 // ----------------------------------------------------------------------
85 // a more complex example
86 // ----------------------------------------------------------------------
89 class MyCanvas
: public wxScrolledWindow
92 MyCanvas(wxWindow
*parent
);
95 void OnPaint(wxPaintEvent
& event
);
96 void OnQueryPosition(wxCommandEvent
& event
);
97 void OnAddButton(wxCommandEvent
& event
);
98 void OnDeleteButton(wxCommandEvent
& event
);
99 void OnMoveButton(wxCommandEvent
& event
);
100 void OnScrollWin(wxCommandEvent
& event
);
101 void OnMouseRightDown(wxMouseEvent
& event
);
102 void OnMouseWheel(wxMouseEvent
& event
);
106 DECLARE_EVENT_TABLE()
109 class MyCanvasFrame
: public wxFrame
112 MyCanvasFrame(wxWindow
*parent
)
113 : wxFrame(parent
, wxID_ANY
, "MyCanvas")
115 m_canvas
= new MyCanvas(this);
117 wxMenu
*menuFile
= new wxMenu();
118 menuFile
->Append(wxID_DELETE
, "&Delete all");
119 menuFile
->Append(wxID_NEW
, "Insert &new");
121 wxMenuBar
*mbar
= new wxMenuBar();
122 mbar
->Append(menuFile
, "&File");
125 Connect(wxID_DELETE
, wxEVT_COMMAND_MENU_SELECTED
,
126 wxCommandEventHandler(MyCanvasFrame::OnDeleteAll
));
127 Connect(wxID_NEW
, wxEVT_COMMAND_MENU_SELECTED
,
128 wxCommandEventHandler(MyCanvasFrame::OnInsertNew
));
134 void OnDeleteAll(wxCommandEvent
& WXUNUSED(event
))
136 m_canvas
->DestroyChildren();
139 void OnInsertNew(wxCommandEvent
& WXUNUSED(event
))
141 (void)new wxButton(m_canvas
, wxID_ANY
, "Hello", wxPoint(100,100));
147 // ----------------------------------------------------------------------------
148 // example using sizers with wxScrolledWindow
149 // ----------------------------------------------------------------------------
151 const wxSize
SMALL_BUTTON( 100, 50 );
152 const wxSize
LARGE_BUTTON( 300, 200 );
154 class MySizerScrolledWindow
: public wxScrolledWindow
157 MySizerScrolledWindow(wxWindow
*parent
);
160 // this button can be clicked to change its own size in the handler below,
161 // the window size will be automatically adjusted to fit the button
164 void OnResizeClick(wxCommandEvent
& event
);
167 class MySizerFrame
: public wxFrame
170 MySizerFrame(wxWindow
*parent
)
171 : wxFrame(parent
, wxID_ANY
, "MySizerScrolledWindow")
173 new MySizerScrolledWindow(this);
175 // ensure that the scrollbars appear when the button becomes large
176 SetClientSize(LARGE_BUTTON
/2);
181 // ----------------------------------------------------------------------------
182 // example showing scrolling only part of the window
183 // ----------------------------------------------------------------------------
185 // this window consists of an empty space in its corner, column labels window
186 // along its top, row labels window along its left hand side and a canvas in
187 // the remaining space
189 class MySubColLabels
: public wxWindow
192 MySubColLabels(wxScrolledWindow
*parent
)
193 : wxWindow(parent
, wxID_ANY
)
197 Connect(wxEVT_PAINT
, wxPaintEventHandler(MySubColLabels::OnPaint
));
201 void OnPaint(wxPaintEvent
& WXUNUSED(event
))
205 // This is wrong.. it will translate both x and y if the
206 // window is scrolled, the label windows are active in one
207 // direction only. Do the action below instead -- RL.
208 //m_owner->PrepareDC( dc );
210 int xScrollUnits
, xOrigin
;
212 m_owner
->GetViewStart( &xOrigin
, 0 );
213 m_owner
->GetScrollPixelsPerUnit( &xScrollUnits
, 0 );
214 dc
.SetDeviceOrigin( -xOrigin
* xScrollUnits
, 0 );
216 dc
.DrawText("Column 1", 5, 5);
217 dc
.DrawText("Column 2", 105, 5);
218 dc
.DrawText("Column 3", 205, 5);
221 wxScrolledWindow
*m_owner
;
224 class MySubRowLabels
: public wxWindow
227 MySubRowLabels(wxScrolledWindow
*parent
)
228 : wxWindow(parent
, wxID_ANY
)
232 Connect(wxEVT_PAINT
, wxPaintEventHandler(MySubRowLabels::OnPaint
));
236 void OnPaint(wxPaintEvent
& WXUNUSED(event
))
240 // This is wrong.. it will translate both x and y if the
241 // window is scrolled, the label windows are active in one
242 // direction only. Do the action below instead -- RL.
243 //m_owner->PrepareDC( dc );
245 int yScrollUnits
, yOrigin
;
247 m_owner
->GetViewStart( 0, &yOrigin
);
248 m_owner
->GetScrollPixelsPerUnit( 0, &yScrollUnits
);
249 dc
.SetDeviceOrigin( 0, -yOrigin
* yScrollUnits
);
251 dc
.DrawText("Row 1", 5, 5);
252 dc
.DrawText("Row 2", 5, 30);
253 dc
.DrawText("Row 3", 5, 55);
254 dc
.DrawText("Row 4", 5, 80);
255 dc
.DrawText("Row 5", 5, 105);
256 dc
.DrawText("Row 6", 5, 130);
259 wxScrolledWindow
*m_owner
;
262 class MySubCanvas
: public wxPanel
265 MySubCanvas(wxScrolledWindow
*parent
, wxWindow
*cols
, wxWindow
*rows
)
266 : wxPanel(parent
, wxID_ANY
)
272 (void)new wxButton(this, wxID_ANY
, "Hallo I",
273 wxPoint(0,50), wxSize(100,25) );
274 (void)new wxButton(this, wxID_ANY
, "Hallo II",
275 wxPoint(200,50), wxSize(100,25) );
277 (void)new wxTextCtrl(this, wxID_ANY
, "Text I",
278 wxPoint(0,100), wxSize(100,25) );
279 (void)new wxTextCtrl(this, wxID_ANY
, "Text II",
280 wxPoint(200,100), wxSize(100,25) );
282 (void)new wxComboBox(this, wxID_ANY
, "ComboBox I",
283 wxPoint(0,150), wxSize(100,25));
284 (void)new wxComboBox(this, wxID_ANY
, "ComboBox II",
285 wxPoint(200,150), wxSize(100,25));
287 SetBackgroundColour("WHEAT");
289 Connect(wxEVT_PAINT
, wxPaintEventHandler(MySubCanvas::OnPaint
));
292 // override the base class function so that when this window is scrolled,
293 // the labels are scrolled in sync
294 virtual void ScrollWindow(int dx
, int dy
, const wxRect
*rect
)
296 wxPanel::ScrollWindow( dx
, dy
, rect
);
297 m_colLabels
->ScrollWindow( dx
, 0, rect
);
298 m_rowLabels
->ScrollWindow( 0, dy
, rect
);
302 void OnPaint(wxPaintEvent
& WXUNUSED(event
))
304 wxPaintDC
dc( this );
305 m_owner
->PrepareDC( dc
);
307 dc
.SetPen( *wxBLACK_PEN
);
309 // OK, let's assume we are a grid control and we have two
310 // grid cells. Here in OnPaint we want to know which cell
311 // to redraw so that we prevent redrawing cells that don't
312 // need to get redrawn. We have one cell at (0,0) and one
313 // more at (200,0), both having a size of (100,25).
315 // We can query how much the window has been scrolled
316 // by calling CalcUnscrolledPosition()
320 m_owner
->CalcUnscrolledPosition( scroll_x
, scroll_y
, &scroll_x
, &scroll_y
);
322 // We also need to know the size of the window to see which
323 // cells are completely hidden and not get redrawn
327 GetClientSize( &size_x
, &size_y
);
329 // First cell: (0,0)(100,25)
331 if ((0+100-scroll_x
> 0) && (0+25-scroll_y
> 0) &&
332 (0-scroll_x
< size_x
) && (0-scroll_y
< size_y
))
334 // Has the region on screen been exposed?
335 if (IsExposed(0,0,100,25))
337 dc
.DrawRectangle( 0, 0, 100, 25 );
338 dc
.DrawText("First Cell", 5, 5);
343 // Second cell: (0,200)(100,25)
345 if ((200+100-scroll_x
> 0) && (0+25-scroll_y
> 0) &&
346 (200-scroll_x
< size_x
) && (0-scroll_y
< size_y
))
348 // Has the region on screen been exposed?
349 if (IsExposed(200,0,100,25))
351 dc
.DrawRectangle( 200, 0, 100, 25 );
352 dc
.DrawText("Second Cell", 205, 5);
357 wxScrolledWindow
*m_owner
;
358 wxWindow
*m_colLabels
,
362 class MySubScrolledWindow
: public wxScrolledWindow
371 MySubScrolledWindow(wxWindow
*parent
)
372 : wxScrolledWindow(parent
, wxID_ANY
)
374 // create the children
375 MySubColLabels
*cols
= new MySubColLabels(this);
376 MySubRowLabels
*rows
= new MySubRowLabels(this);
378 m_canvas
= new MySubCanvas(this, cols
, rows
);
381 wxFlexGridSizer
*sizer
= new wxFlexGridSizer(2, 2, 10, 10);
382 sizer
->Add(CORNER_WIDTH
, CORNER_HEIGHT
); // just a spacer
383 sizer
->Add(cols
, wxSizerFlags().Expand());
384 sizer
->Add(rows
, wxSizerFlags().Expand());
385 sizer
->Add(m_canvas
, wxSizerFlags().Expand());
386 sizer
->AddGrowableRow(1);
387 sizer
->AddGrowableCol(1);
390 // this is the key call: it means that only m_canvas will be scrolled
391 // and not this window itself
392 SetTargetWindow(m_canvas
);
394 SetScrollbars(10, 10, 50, 50);
396 Connect(wxEVT_SIZE
, wxSizeEventHandler(MySubScrolledWindow::OnSize
));
400 // scrolled windows which use scroll target different from the window
401 // itself must override this virtual method
402 virtual wxSize
GetSizeAvailableForScrollTarget(const wxSize
& size
)
404 // decrease the total size by the size of the non-scrollable parts
405 // above/to the left of the canvas
406 wxSize
sizeCanvas(size
);
413 void OnSize(wxSizeEvent
& WXUNUSED(event
))
415 // We need to override OnSize so that our scrolled
416 // window a) does call Layout() to use sizers for
417 // positioning the controls but b) does not query
418 // the sizer for their size and use that for setting
419 // the scrollable area as set that ourselves by
420 // calling SetScrollbar() further down.
427 MySubCanvas
*m_canvas
;
430 class MySubFrame
: public wxFrame
433 MySubFrame(wxWindow
*parent
)
434 : wxFrame(parent
, wxID_ANY
, "MySubScrolledWindow")
436 new MySubScrolledWindow(this);
442 // ----------------------------------------------------------------------------
443 // more simple examples of wxScrolledWindow usage
444 // ----------------------------------------------------------------------------
446 // base class for both of them
447 class MyScrolledWindowBase
: public wxScrolledWindow
450 MyScrolledWindowBase(wxWindow
*parent
)
451 : wxScrolledWindow(parent
, wxID_ANY
,
452 wxDefaultPosition
, wxDefaultSize
,
460 dc
.GetTextExtent("Line 17", NULL
, &m_hLine
);
463 // this scrolled window can be synchronized with another one: if this
464 // function is called with a non-NULL pointer, the given window will be
465 // scrolled to the same position as this one
466 void SyncWith(MyScrolledWindowBase
*win
)
473 virtual void ScrollWindow(int dx
, int dy
, const wxRect
*rect
= NULL
)
475 wxScrolledWindow::ScrollWindow(dx
, dy
, rect
);
481 // the height of one line on screen
484 // the number of lines we draw
488 bool WasScrolledFirst() const { return m_inDoSync
; }
490 void DoSyncIfNecessary()
492 if ( m_winSync
&& !m_winSync
->WasScrolledFirst() )
496 m_winSync
->Scroll(GetViewStart());
502 // the window to synchronize with this one or NULL
503 MyScrolledWindowBase
*m_winSync
;
505 // the flag preventing infinite recursion which would otherwise happen if
506 // one window synchronized the other one which in turn synchronized this
511 // this class does "stupid" redrawing - it redraws everything each time
512 // and sets the scrollbar extent directly.
514 class MyScrolledWindowDumb
: public MyScrolledWindowBase
517 MyScrolledWindowDumb(wxWindow
*parent
) : MyScrolledWindowBase(parent
)
520 SetScrollbars(0, m_hLine
, 0, m_nLines
+ 1, 0, 0, true /* no refresh */);
523 virtual void OnDraw(wxDC
& dc
);
526 // this class does "smart" redrawing - only redraws the lines which must be
527 // redrawn and sets the scroll rate and virtual size to affect the
530 // Note that this class should produce identical results to the one above.
532 class MyScrolledWindowSmart
: public MyScrolledWindowBase
535 MyScrolledWindowSmart(wxWindow
*parent
) : MyScrolledWindowBase(parent
)
538 SetScrollRate( 0, m_hLine
);
539 SetVirtualSize( wxDefaultCoord
, ( m_nLines
+ 1 ) * m_hLine
);
542 virtual void OnDraw(wxDC
& dc
);
545 // ----------------------------------------------------------------------------
546 // implements a text viewer with simple block selection to test auto-scrolling
548 // ----------------------------------------------------------------------------
550 class MyAutoScrollingWindow
: public wxScrolledWindow
553 MyAutoScrollingWindow( wxWindow
* parent
);
554 wxRect
DeviceCoordsToGraphicalChars(wxRect updRect
) const;
555 wxPoint
DeviceCoordsToGraphicalChars(wxPoint pos
) const;
556 wxPoint
GraphicalCharToDeviceCoords(wxPoint pos
) const;
557 wxRect
LogicalCoordsToGraphicalChars(wxRect updRect
) const;
558 wxPoint
LogicalCoordsToGraphicalChars(wxPoint pos
) const;
559 wxPoint
GraphicalCharToLogicalCoords(wxPoint pos
) const;
561 bool IsSelected(int chX
, int chY
) const;
562 static bool IsInside(int k
, int bound1
, int bound2
);
563 static wxRect
DCNormalize(int x
, int y
, int w
, int h
);
567 void OnDraw(wxDC
& dc
);
568 void OnMouseLeftDown(wxMouseEvent
& event
);
569 void OnMouseLeftUp(wxMouseEvent
& event
);
570 void OnMouseMove(wxMouseEvent
& event
);
571 void OnMouseCaptureLost(wxMouseCaptureLostEvent
& event
);
572 void OnScroll(wxScrollWinEvent
& event
);
574 // test data variables
575 static const char* sm_testData
;
576 static const int sm_lineCnt
; // line count
577 static const int sm_lineLen
; // line length in characters
578 // sizes for graphical data
579 int m_fontH
, m_fontW
;
580 // selection tracking
581 wxPoint m_selStart
; // beginning of blockwise selection
582 wxPoint m_cursor
; // end of blockwise selection (mouse position)
588 DECLARE_EVENT_TABLE()
591 class MyAutoFrame
: public wxFrame
594 MyAutoFrame(wxWindow
*parent
)
595 : wxFrame(parent
, wxID_ANY
, "MyAutoScrollingWindow")
597 new MyAutoScrollingWindow(this);
604 // ----------------------------------------------------------------------------
605 // MyFrame: the main application frame showing all the classes above
606 // ----------------------------------------------------------------------------
608 class MyFrame
: public wxFrame
614 void OnAbout(wxCommandEvent
& event
);
615 void OnQuit(wxCommandEvent
& event
);
617 void OnTestSimple(wxCommandEvent
& WXUNUSED(event
)) { new MySimpleFrame(this); }
618 void OnTestCanvas(wxCommandEvent
& WXUNUSED(event
)) { new MyCanvasFrame(this); }
619 void OnTestSizer(wxCommandEvent
& WXUNUSED(event
)) { new MySizerFrame(this); }
620 void OnTestSub(wxCommandEvent
& WXUNUSED(event
)) { new MySubFrame(this); }
621 void OnTestAuto(wxCommandEvent
& WXUNUSED(event
)) { new MyAutoFrame(this); }
623 void OnToggleSync(wxCommandEvent
& event
);
624 void OnToggleScrollbar(wxCommandEvent
& event
);
626 MyScrolledWindowBase
*m_win1
,
629 DECLARE_EVENT_TABLE()
632 // ----------------------------------------------------------------------------
634 // ----------------------------------------------------------------------------
636 class MyApp
: public wxApp
639 virtual bool OnInit();
643 // ============================================================================
645 // ============================================================================
647 // ----------------------------------------------------------------------------
649 // ----------------------------------------------------------------------------
651 const wxWindowID ID_ADDBUTTON
= wxWindow::NewControlId();
652 const wxWindowID ID_DELBUTTON
= wxWindow::NewControlId();
653 const wxWindowID ID_MOVEBUTTON
= wxWindow::NewControlId();
654 const wxWindowID ID_SCROLLWIN
= wxWindow::NewControlId();
655 const wxWindowID ID_QUERYPOS
= wxWindow::NewControlId();
657 const wxWindowID ID_NEWBUTTON
= wxWindow::NewControlId();
659 BEGIN_EVENT_TABLE(MyCanvas
, wxScrolledWindow
)
660 EVT_PAINT( MyCanvas::OnPaint
)
661 EVT_RIGHT_DOWN( MyCanvas::OnMouseRightDown
)
662 EVT_MOUSEWHEEL( MyCanvas::OnMouseWheel
)
663 EVT_BUTTON( ID_QUERYPOS
, MyCanvas::OnQueryPosition
)
664 EVT_BUTTON( ID_ADDBUTTON
, MyCanvas::OnAddButton
)
665 EVT_BUTTON( ID_DELBUTTON
, MyCanvas::OnDeleteButton
)
666 EVT_BUTTON( ID_MOVEBUTTON
, MyCanvas::OnMoveButton
)
667 EVT_BUTTON( ID_SCROLLWIN
, MyCanvas::OnScrollWin
)
670 MyCanvas::MyCanvas(wxWindow
*parent
)
671 : wxScrolledWindow(parent
, wxID_ANY
,
672 wxDefaultPosition
, wxDefaultSize
,
673 wxSUNKEN_BORDER
| wxTAB_TRAVERSAL
)
675 // you can use either a single SetScrollbars() call or these 2 functions,
676 // usually using them is better because you normally won't need to change
677 // the scroll rate in the future and the sizer can be used to update the
678 // virtual size automatically
679 SetScrollRate( 10, 10 );
680 SetVirtualSize( 500, 1000 );
682 (void) new wxButton( this, ID_ADDBUTTON
, "add button", wxPoint(10,10) );
683 (void) new wxButton( this, ID_DELBUTTON
, "del button", wxPoint(10,40) );
684 (void) new wxButton( this, ID_MOVEBUTTON
, "move button", wxPoint(150,10) );
685 (void) new wxButton( this, ID_SCROLLWIN
, "scroll win", wxPoint(250,10) );
687 wxPanel
*test
= new wxPanel( this, wxID_ANY
,
688 wxPoint(10, 110), wxSize(130,50),
689 wxSIMPLE_BORDER
| wxTAB_TRAVERSAL
);
690 test
->SetBackgroundColour( "WHEAT" );
692 SetBackgroundColour( "BLUE" );
695 void MyCanvas::OnMouseRightDown( wxMouseEvent
&event
)
697 wxPoint
pt( event
.GetPosition() );
699 CalcUnscrolledPosition( pt
.x
, pt
.y
, &x
, &y
);
700 wxLogMessage("Mouse down event at: %d %d, scrolled: %d %d",
704 void MyCanvas::OnMouseWheel( wxMouseEvent
&event
)
706 wxPoint
pt( event
.GetPosition() );
708 CalcUnscrolledPosition( pt
.x
, pt
.y
, &x
, &y
);
709 wxLogMessage( "Mouse wheel event at: %d %d, scrolled: %d %d\n"
710 "Rotation: %d, delta = %d",
712 event
.GetWheelRotation(), event
.GetWheelDelta() );
717 void MyCanvas::OnPaint( wxPaintEvent
&WXUNUSED(event
) )
719 wxPaintDC
dc( this );
722 dc
.DrawText( "Press right mouse button to test calculations!", 160, 50 );
724 dc
.DrawText( "Some text", 140, 140 );
726 dc
.DrawRectangle( 100, 160, 200, 200 );
729 void MyCanvas::OnQueryPosition( wxCommandEvent
&WXUNUSED(event
) )
731 wxPoint
pt( m_button
->GetPosition() );
732 wxLogMessage( "Position of \"Query position\" is %d %d", pt
.x
, pt
.y
);
733 pt
= ClientToScreen( pt
);
734 wxLogMessage("Position of \"Query position\" on screen is %d %d",
738 void MyCanvas::OnAddButton( wxCommandEvent
&WXUNUSED(event
) )
740 wxLogMessage( "Inserting button at position 10,70..." );
741 wxButton
*button
= new wxButton( this, ID_NEWBUTTON
, "new button",
742 wxPoint(10,70), wxSize(80,25) );
743 wxPoint
pt( button
->GetPosition() );
744 wxLogMessage( "-> Position after inserting %d %d", pt
.x
, pt
.y
);
747 void MyCanvas::OnDeleteButton( wxCommandEvent
&WXUNUSED(event
) )
749 wxLogMessage( "Deleting button inserted with \"Add button\"..." );
750 wxWindow
*win
= FindWindow( ID_NEWBUTTON
);
754 wxLogMessage( "-> No window with id = ID_NEWBUTTON found." );
757 void MyCanvas::OnMoveButton( wxCommandEvent
&event
)
759 wxLogMessage( "Moving button 10 pixels downward.." );
760 wxWindow
*win
= FindWindow( event
.GetId() );
761 wxPoint
pt( win
->GetPosition() );
762 wxLogMessage( "-> Position before move is %d %d", pt
.x
, pt
.y
);
763 win
->Move( wxDefaultCoord
, pt
.y
+ 10 );
764 pt
= win
->GetPosition();
765 wxLogMessage( "-> Position after move is %d %d", pt
.x
, pt
.y
);
768 void MyCanvas::OnScrollWin( wxCommandEvent
&WXUNUSED(event
) )
770 wxLogMessage("Scrolling 2 units up.\n"
771 "The white square and the controls should move equally!");
772 Scroll( wxDefaultCoord
, GetViewStart().y
+2 );
775 // ----------------------------------------------------------------------------
776 // MySizerScrolledWindow
777 // ----------------------------------------------------------------------------
779 MySizerScrolledWindow::MySizerScrolledWindow(wxWindow
*parent
)
780 : wxScrolledWindow(parent
)
782 SetBackgroundColour( "GREEN" );
784 // Set the rate we'd like for scrolling.
786 SetScrollRate( 5, 5 );
788 // Populate a sizer with a 'resizing' button and some other static
791 wxFlexGridSizer
*sizer
= new wxFlexGridSizer(2);
793 m_button
= new wxButton( this, wxID_RESIZE_FRAME
, "Press me",
794 wxDefaultPosition
, SMALL_BUTTON
);
796 sizer
->Add(m_button
, wxSizerFlags().Centre().Border(20));
797 sizer
->Add(new wxStaticText(this, wxID_ANY
, "This is just"),
798 wxSizerFlags().Centre());
799 sizer
->Add(new wxStaticText(this, wxID_ANY
, "some decoration"),
800 wxSizerFlags().Centre());
801 sizer
->Add(new wxStaticText(this, wxID_ANY
, "for you to scroll..."),
802 wxSizerFlags().Centre());
804 // Then use the sizer to set the scrolled region size.
808 Connect(wxID_RESIZE_FRAME
, wxEVT_COMMAND_BUTTON_CLICKED
,
809 wxCommandEventHandler(MySizerScrolledWindow::OnResizeClick
));
812 void MySizerScrolledWindow::OnResizeClick(wxCommandEvent
&WXUNUSED(event
))
814 // Arbitrarily resize the button to change the minimum size of
815 // the (scrolled) sizer.
817 if ( m_button
->GetSize() == SMALL_BUTTON
)
818 m_button
->SetSizeHints(LARGE_BUTTON
);
820 m_button
->SetSizeHints(SMALL_BUTTON
);
822 // Force update layout and scrollbars, since nothing we do here
823 // necessarily generates a size event which would do it for us.
827 // ----------------------------------------------------------------------------
829 // ----------------------------------------------------------------------------
831 const wxWindowID Scroll_Test_Simple
= wxWindow::NewControlId();
832 const wxWindowID Scroll_Test_Canvas
= wxWindow::NewControlId();
833 const wxWindowID Scroll_Test_Sizers
= wxWindow::NewControlId();
834 const wxWindowID Scroll_Test_Sub
= wxWindow::NewControlId();
835 const wxWindowID Scroll_Test_Auto
= wxWindow::NewControlId();
837 const wxWindowID Scroll_TglBtn_Sync
= wxWindow::NewControlId();
838 const wxWindowID Scroll_TglBtn_Scrollbar
= wxWindow::NewControlId();
840 BEGIN_EVENT_TABLE(MyFrame
,wxFrame
)
841 EVT_MENU(wxID_ABOUT
, MyFrame::OnAbout
)
842 EVT_MENU(wxID_EXIT
, MyFrame::OnQuit
)
844 EVT_MENU(Scroll_Test_Simple
, MyFrame::OnTestSimple
)
845 EVT_MENU(Scroll_Test_Canvas
, MyFrame::OnTestCanvas
)
846 EVT_MENU(Scroll_Test_Sizers
, MyFrame::OnTestSizer
)
847 EVT_MENU(Scroll_Test_Sub
, MyFrame::OnTestSub
)
848 EVT_MENU(Scroll_Test_Auto
, MyFrame::OnTestAuto
)
850 EVT_TOGGLEBUTTON(Scroll_TglBtn_Sync
, MyFrame::OnToggleSync
)
851 EVT_TOGGLEBUTTON(Scroll_TglBtn_Scrollbar
, MyFrame::OnToggleScrollbar
)
855 : wxFrame(NULL
, wxID_ANY
, "wxWidgets scroll sample")
857 wxMenu
*menuFile
= new wxMenu
;
858 menuFile
->Append(wxID_ABOUT
, "&About..");
859 menuFile
->AppendSeparator();
860 menuFile
->Append(wxID_EXIT
, "E&xit\tAlt-X");
862 wxMenu
*menuTest
= new wxMenu
;
863 menuTest
->Append(Scroll_Test_Simple
, "&Simple scroll window\tF1",
864 "Simplest possible scrolled window test.");
865 menuTest
->Append(Scroll_Test_Canvas
, "Scrolled window with &children\tF2",
866 "Scrolled window with controls on it.");
867 menuTest
->Append(Scroll_Test_Sizers
, "Scrolled window with si&zer\tF3",
868 "Scrolled window with children managed by sizer.");
869 menuTest
->Append(Scroll_Test_Sub
, "Scrolled s&ub-window\tF4",
870 "Window only part of which is scrolled.");
871 menuTest
->Append(Scroll_Test_Auto
, "&Auto-scrolled window\tF5",
872 "Window which scrolls when the mouse is held pressed "
875 wxMenuBar
*mbar
= new wxMenuBar
;
876 mbar
->Append(menuFile
, "&File");
877 mbar
->Append(menuTest
, "&Test");
882 const wxSizerFlags
flagsExpand(wxSizerFlags(1).Expand());
884 wxSizer
*topsizer
= new wxBoxSizer(wxVERTICAL
);
885 topsizer
->Add(new wxStaticText(this, wxID_ANY
,
886 "The windows below should behave in the same way, even though\n"
887 "they're implemented quite differently, see the code for details.\n"
889 "The lines redrawn during odd/even repaint iterations are drawn in\n"
890 "red/blue colour to allow seeing immediately how much is repainted,\n"
891 "don't be surprised by this."),
892 wxSizerFlags().Centre().Border());
894 m_win1
= new MyScrolledWindowDumb(this);
895 m_win2
= new MyScrolledWindowSmart(this);
897 wxSizer
*sizerScrollWin
= new wxBoxSizer(wxHORIZONTAL
);
898 sizerScrollWin
->Add(m_win1
, flagsExpand
);
899 sizerScrollWin
->Add(m_win2
, flagsExpand
);
900 topsizer
->Add(sizerScrollWin
, flagsExpand
);
902 const wxSizerFlags
flagsHBorder(wxSizerFlags().Border(wxLEFT
| wxRIGHT
));
904 wxSizer
*sizerBtns
= new wxBoxSizer(wxHORIZONTAL
);
905 sizerBtns
->Add(new wxToggleButton(this, Scroll_TglBtn_Sync
, "S&ynchronize"),
908 wxToggleButton
*btn
=new wxToggleButton(this, Scroll_TglBtn_Scrollbar
,
911 sizerBtns
->Add(btn
, flagsHBorder
);
912 topsizer
->Add(sizerBtns
, wxSizerFlags().Centre().Border());
920 void MyFrame::OnToggleSync(wxCommandEvent
& event
)
922 if ( event
.IsChecked() )
924 m_win1
->SyncWith(m_win2
);
925 m_win2
->SyncWith(m_win1
);
929 m_win1
->SyncWith(NULL
);
930 m_win2
->SyncWith(NULL
);
934 void MyFrame::OnToggleScrollbar(wxCommandEvent
& event
)
936 m_win1
->ShowScrollbars(wxSHOW_SB_NEVER
,
937 event
.IsChecked() ? wxSHOW_SB_ALWAYS
941 void MyFrame::OnQuit(wxCommandEvent
&WXUNUSED(event
))
946 void MyFrame::OnAbout( wxCommandEvent
&WXUNUSED(event
) )
948 (void)wxMessageBox( "wxScrolledWindow sample\n"
950 "Robert Roebling (c) 1998\n"
951 "Vadim Zeitlin (c) 2008\n"
952 "Autoscrolling examples\n"
954 "Auto-timed-scrolling example\n"
955 "Matt Gregory (c) 2003\n",
956 "About wxWidgets scroll sample",
957 wxICON_INFORMATION
| wxOK
);
960 // ----------------------------------------------------------------------------
962 // ----------------------------------------------------------------------------
968 if ( !wxApp::OnInit() )
976 // ----------------------------------------------------------------------------
977 // MyScrolledWindowXXX
978 // ----------------------------------------------------------------------------
980 void MyScrolledWindowDumb::OnDraw(wxDC
& dc
)
982 // this is useful to see which lines are redrawn
983 static size_t s_redrawCount
= 0;
984 dc
.SetTextForeground(s_redrawCount
++ % 2 ? *wxRED
: *wxBLUE
);
987 for ( size_t line
= 0; line
< m_nLines
; line
++ )
990 CalcScrolledPosition(0, y
, NULL
, &yPhys
);
992 dc
.DrawText(wxString::Format("Line %u (logical %d, physical %d)",
993 unsigned(line
), y
, yPhys
), 0, y
);
998 void MyScrolledWindowSmart::OnDraw(wxDC
& dc
)
1000 // this is useful to see which lines are redrawn
1001 static size_t s_redrawCount
= 0;
1002 dc
.SetTextForeground(s_redrawCount
++ % 2 ? *wxRED
: *wxBLUE
);
1004 // update region is always in device coords, translate to logical ones
1005 wxRect rectUpdate
= GetUpdateRegion().GetBox();
1006 CalcUnscrolledPosition(rectUpdate
.x
, rectUpdate
.y
,
1007 &rectUpdate
.x
, &rectUpdate
.y
);
1009 size_t lineFrom
= rectUpdate
.y
/ m_hLine
,
1010 lineTo
= rectUpdate
.GetBottom() / m_hLine
;
1012 if ( lineTo
> m_nLines
- 1)
1013 lineTo
= m_nLines
- 1;
1015 int y
= lineFrom
*m_hLine
;
1016 for ( size_t line
= lineFrom
; line
<= lineTo
; line
++ )
1019 CalcScrolledPosition(0, y
, NULL
, &yPhys
);
1021 dc
.DrawText(wxString::Format("Line %u (logical %d, physical %d)",
1022 unsigned(line
), y
, yPhys
), 0, y
);
1027 // ----------------------------------------------------------------------------
1028 // MyAutoScrollingWindow
1029 // ----------------------------------------------------------------------------
1031 BEGIN_EVENT_TABLE(MyAutoScrollingWindow
, wxScrolledWindow
)
1032 EVT_LEFT_DOWN(MyAutoScrollingWindow::OnMouseLeftDown
)
1033 EVT_LEFT_UP(MyAutoScrollingWindow::OnMouseLeftUp
)
1034 EVT_MOTION(MyAutoScrollingWindow::OnMouseMove
)
1035 EVT_MOUSE_CAPTURE_LOST(MyAutoScrollingWindow::OnMouseCaptureLost
)
1036 EVT_SCROLLWIN(MyAutoScrollingWindow::OnScroll
)
1039 MyAutoScrollingWindow::MyAutoScrollingWindow(wxWindow
* parent
)
1040 : wxScrolledWindow(parent
, wxID_ANY
, wxDefaultPosition
, wxDefaultSize
,
1041 wxVSCROLL
| wxHSCROLL
| wxSUNKEN_BORDER
),
1044 m_font(9, wxFONTFAMILY_TELETYPE
, wxFONTSTYLE_NORMAL
, wxFONTWEIGHT_NORMAL
)
1046 wxClientDC
dc(this);
1047 // query dc for text size
1049 dc
.GetTextExtent(wxString("A"), &m_fontW
, &m_fontH
);
1050 // set up the virtual window
1051 SetScrollbars(m_fontW
, m_fontH
, sm_lineLen
, sm_lineCnt
);
1055 MyAutoScrollingWindow::DeviceCoordsToGraphicalChars(wxRect updRect
) const
1057 wxPoint
pos(updRect
.GetPosition());
1058 pos
= DeviceCoordsToGraphicalChars(pos
);
1061 updRect
.width
/= m_fontW
;
1062 updRect
.height
/= m_fontH
;
1063 // the *CoordsToGraphicalChars() funcs round down to upper-left corner,
1064 // so an off-by-one correction is needed
1065 ++updRect
.width
; // kludge
1066 ++updRect
.height
; // kludge
1071 MyAutoScrollingWindow::DeviceCoordsToGraphicalChars(wxPoint pos
) const
1075 pos
+= GetViewStart();
1080 MyAutoScrollingWindow::GraphicalCharToDeviceCoords(wxPoint pos
) const
1082 pos
-= GetViewStart();
1089 MyAutoScrollingWindow::LogicalCoordsToGraphicalChars(wxRect updRect
) const
1091 wxPoint
pos(updRect
.GetPosition());
1092 pos
= LogicalCoordsToGraphicalChars(pos
);
1095 updRect
.width
/= m_fontW
;
1096 updRect
.height
/= m_fontH
;
1097 // the *CoordsToGraphicalChars() funcs round down to upper-left corner,
1098 // so an off-by-one correction is needed
1099 ++updRect
.width
; // kludge
1100 ++updRect
.height
; // kludge
1105 MyAutoScrollingWindow::LogicalCoordsToGraphicalChars(wxPoint pos
) const
1113 MyAutoScrollingWindow::GraphicalCharToLogicalCoords(wxPoint pos
) const
1120 void MyAutoScrollingWindow::MyRefresh()
1122 static wxPoint
lastSelStart(-1, -1), lastCursor(-1, -1);
1123 // refresh last selected area (to deselect previously selected text)
1125 GraphicalCharToDeviceCoords(lastSelStart
),
1126 GraphicalCharToDeviceCoords(lastCursor
)
1128 // off-by-one corrections, necessary because it's not possible to know
1129 // when to round up until rect is normalized by lastUpdRect constructor
1130 lastUpdRect
.width
+= m_fontW
; // kludge
1131 lastUpdRect
.height
+= m_fontH
; // kludge
1132 // refresh currently selected (to select previously unselected text)
1134 GraphicalCharToDeviceCoords(m_selStart
),
1135 GraphicalCharToDeviceCoords(m_cursor
)
1137 // off-by-one corrections
1138 updRect
.width
+= m_fontW
; // kludge
1139 updRect
.height
+= m_fontH
; // kludge
1140 // find necessary refresh areas
1141 int rx
= lastUpdRect
.x
;
1142 int ry
= lastUpdRect
.y
;
1143 int rw
= updRect
.x
- lastUpdRect
.x
;
1144 int rh
= lastUpdRect
.height
;
1146 RefreshRect(DCNormalize(rx
, ry
, rw
, rh
));
1149 ry
= updRect
.y
+ updRect
.height
;
1151 rh
= (lastUpdRect
.y
+ lastUpdRect
.height
) - (updRect
.y
+ updRect
.height
);
1153 RefreshRect(DCNormalize(rx
, ry
, rw
, rh
));
1155 rx
= updRect
.x
+ updRect
.width
;
1157 rw
= (lastUpdRect
.x
+ lastUpdRect
.width
) - (updRect
.x
+ updRect
.width
);
1158 rh
= lastUpdRect
.height
;
1160 RefreshRect(DCNormalize(rx
, ry
, rw
, rh
));
1165 rh
= updRect
.y
- lastUpdRect
.y
;
1167 RefreshRect(DCNormalize(rx
, ry
, rw
, rh
));
1170 lastSelStart
= m_selStart
;
1171 lastCursor
= m_cursor
;
1174 bool MyAutoScrollingWindow::IsSelected(int chX
, int chY
) const
1176 if (IsInside(chX
, m_selStart
.x
, m_cursor
.x
)
1177 && IsInside(chY
, m_selStart
.y
, m_cursor
.y
)) {
1183 bool MyAutoScrollingWindow::IsInside(int k
, int bound1
, int bound2
)
1185 if ((k
>= bound1
&& k
<= bound2
) || (k
>= bound2
&& k
<= bound1
)) {
1192 MyAutoScrollingWindow::DCNormalize(int x
, int y
, int w
, int h
)
1194 // this is needed to get rid of the graphical remnants from the selection
1195 // I think it's because DrawRectangle() excludes a pixel in either direction
1196 const int kludge
= 1;
1197 // make (x, y) the top-left corner
1212 return wxRect(x
, y
, w
, h
);
1215 void MyAutoScrollingWindow::OnDraw(wxDC
& dc
)
1218 wxBrush
normBrush(wxSystemSettings::GetColour(wxSYS_COLOUR_WINDOW
)
1220 wxBrush
selBrush(wxSystemSettings::GetColour(wxSYS_COLOUR_HIGHLIGHT
)
1222 dc
.SetPen(*wxTRANSPARENT_PEN
);
1223 const wxString str
= sm_testData
;
1224 size_t strLength
= str
.length();
1225 wxString::const_iterator str_i
;
1227 // draw the characters
1228 // 1. for each update region
1229 for (wxRegionIterator
upd(GetUpdateRegion()); upd
; ++upd
) {
1230 wxRect updRect
= upd
.GetRect();
1231 wxRect
updRectInGChars(DeviceCoordsToGraphicalChars(updRect
));
1232 // 2. for each row of chars in the update region
1233 for (int chY
= updRectInGChars
.y
1234 ; chY
<= updRectInGChars
.y
+ updRectInGChars
.height
; ++chY
) {
1235 // 3. for each character in the row
1236 bool isFirstX
= true;
1237 for (int chX
= updRectInGChars
.x
1238 ; chX
<= updRectInGChars
.x
+ updRectInGChars
.width
1241 if (IsSelected(chX
, chY
)) {
1242 dc
.SetBrush(selBrush
);
1243 dc
.SetTextForeground( wxSystemSettings::GetColour
1244 (wxSYS_COLOUR_HIGHLIGHTTEXT
));
1246 dc
.SetBrush(normBrush
);
1247 dc
.SetTextForeground( wxSystemSettings::GetColour
1248 (wxSYS_COLOUR_WINDOWTEXT
));
1250 // 5. find position info
1251 wxPoint charPos
= GraphicalCharToLogicalCoords(wxPoint
1254 dc
.DrawRectangle(charPos
.x
, charPos
.y
, m_fontW
, m_fontH
);
1255 size_t charIndex
= chY
* sm_lineLen
+ chX
;
1256 if (chY
< sm_lineCnt
&&
1258 charIndex
< strLength
)
1262 str_i
= str
.begin() + charIndex
;
1265 dc
.DrawText(*str_i
, charPos
.x
, charPos
.y
);
1273 void MyAutoScrollingWindow::OnMouseLeftDown(wxMouseEvent
& event
)
1275 // initial press of mouse button sets the beginning of the selection
1276 m_selStart
= DeviceCoordsToGraphicalChars(event
.GetPosition());
1277 // set the cursor to the same position
1278 m_cursor
= m_selStart
;
1279 // draw/erase selection
1283 void MyAutoScrollingWindow::OnMouseLeftUp(wxMouseEvent
& WXUNUSED(event
))
1285 // this test is necessary
1292 void MyAutoScrollingWindow::OnMouseMove(wxMouseEvent
& event
)
1294 // if user is dragging
1295 if (event
.Dragging() && event
.LeftIsDown()) {
1296 // set the new cursor position
1297 m_cursor
= DeviceCoordsToGraphicalChars(event
.GetPosition());
1298 // draw/erase selection
1300 // capture mouse to activate auto-scrolling
1301 if (!HasCapture()) {
1308 MyAutoScrollingWindow::OnMouseCaptureLost(wxMouseCaptureLostEvent
&
1311 // we only capture mouse for timed scrolling, so nothing is needed here
1312 // other than making sure to not call event.Skip()
1315 void MyAutoScrollingWindow::OnScroll(wxScrollWinEvent
& event
)
1317 // need to move the cursor when autoscrolling
1318 // FIXME: the cursor also moves when the scrollbar arrows are clicked
1320 if (event
.GetOrientation() == wxHORIZONTAL
) {
1321 if (event
.GetEventType() == wxEVT_SCROLLWIN_LINEUP
) {
1323 } else if (event
.GetEventType() == wxEVT_SCROLLWIN_LINEDOWN
) {
1326 } else if (event
.GetOrientation() == wxVERTICAL
) {
1327 if (event
.GetEventType() == wxEVT_SCROLLWIN_LINEUP
) {
1329 } else if (event
.GetEventType() == wxEVT_SCROLLWIN_LINEDOWN
) {
1338 const int MyAutoScrollingWindow::sm_lineCnt
= 125;
1339 const int MyAutoScrollingWindow::sm_lineLen
= 79;
1340 const char *MyAutoScrollingWindow::sm_testData
=
1341 "162 Cult of the genius out of vanity. Because we think well of ourselves, but "
1342 "nonetheless never suppose ourselves capable of producing a painting like one of "
1343 "Raphael's or a dramatic scene like one of Shakespeare's, we convince ourselves "
1344 "that the capacity to do so is quite extraordinarily marvelous, a wholly "
1345 "uncommon accident, or, if we are still religiously inclined, a mercy from on "
1346 "high. Thus our vanity, our self-love, promotes the cult of the genius: for only "
1347 "if we think of him as being very remote from us, as a miraculum, does he not "
1348 "aggrieve us (even Goethe, who was without envy, called Shakespeare his star of "
1349 "the most distant heights [\"William! Stern der schonsten Ferne\": from Goethe's, "
1350 "\"Between Two Worlds\"]; in regard to which one might recall the lines: \"the "
1351 "stars, these we do not desire\" [from Goethe's, \"Comfort in Tears\"]). But, aside "
1352 "from these suggestions of our vanity, the activity of the genius seems in no "
1353 "way fundamentally different from the activity of the inventor of machines, the "
1354 "scholar of astronomy or history, the master of tactics. All these activities "
1355 "are explicable if one pictures to oneself people whose thinking is active in "
1356 "one direction, who employ everything as material, who always zealously observe "
1357 "their own inner life and that of others, who perceive everywhere models and "
1358 "incentives, who never tire of combining together the means available to them. "
1359 "Genius too does nothing except learn first how to lay bricks then how to build, "
1360 "except continually seek for material and continually form itself around it. "
1361 "Every activity of man is amazingly complicated, not only that of the genius: "
1362 "but none is a \"miracle.\" Whence, then, the belief that genius exists only in "
1363 "the artist, orator and philosopher? that only they have \"intuition\"? (Whereby "
1364 "they are supposed to possess a kind of miraculous eyeglass with which they can "
1365 "see directly into \"the essence of the thing\"!) It is clear that people speak of "
1366 "genius only where the effects of the great intellect are most pleasant to them "
1367 "and where they have no desire to feel envious. To call someone \"divine\" means: "
1368 "\"here there is no need for us to compete.\" Then, everything finished and "
1369 "complete is regarded with admiration, everything still becoming is undervalued. "
1370 "But no one can see in the work of the artist how it has become; that is its "
1371 "advantage, for wherever one can see the act of becoming one grows somewhat "
1372 "cool. The finished and perfect art of representation repulses all thinking as "
1373 "to how it has become; it tyrannizes as present completeness and perfection. "
1374 "That is why the masters of the art of representation count above all as gifted "
1375 "with genius and why men of science do not. In reality, this evaluation of the "
1376 "former and undervaluation of the latter is only a piece of childishness in the "
1379 "163 The serious workman. Do not talk about giftedness, inborn talents! One can "
1380 "name great men of all kinds who were very little gifted. The acquired "
1381 "greatness, became \"geniuses\" (as we put it), through qualities the lack of "
1382 "which no one who knew what they were would boast of: they all possessed that "
1383 "seriousness of the efficient workman which first learns to construct the parts "
1384 "properly before it ventures to fashion a great whole; they allowed themselves "
1385 "time for it, because they took more pleasure in making the little, secondary "
1386 "things well than in the effect of a dazzling whole. the recipe for becoming a "
1387 "good novelist, for example, is easy to give, but to carry it out presupposes "
1388 "qualities one is accustomed to overlook when one says \"I do not have enough "
1389 "talent.\" One has only to make a hundred or so sketches for novels, none longer "
1390 "than two pages but of such distinctness that every word in them is necessary; "
1391 "one should write down anecdotes each day until one has learned how to give them "
1392 "the most pregnant and effective form; one should be tireless in collecting and "
1393 "describing human types and characters; one should above all relate things to "
1394 "others and listen to others relate, keeping one's eyes and ears open for the "
1395 "effect produced on those present, one should travel like a landscape painter or "
1396 "costume designer; one should excerpt for oneself out of the individual sciences "
1397 "everything that will produce an artistic effect when it is well described, one "
1398 "should, finally, reflect on the motives of human actions, disdain no signpost "
1399 "to instruction about them and be a collector of these things by day and night. "
1400 "One should continue in this many-sided exercise some ten years: what is then "
1401 "created in the workshop, however, will be fit to go out into the world. What, "
1402 "however, do most people do? They begin, not with the parts, but with the whole. "
1403 "Perhaps they chance to strike a right note, excite attention and from then on "
1404 "strike worse and worse notes, for good, natural reasons. Sometimes, when the "
1405 "character and intellect needed to formulate such a life-plan are lacking, fate "
1406 "and need take their place and lead the future master step by step through all "
1407 "the stipulations of his trade. "
1409 "164 Peril and profit in the cult of the genius. The belief in great, superior, "
1410 "fruitful spirits is not necessarily, yet nonetheless is very frequently "
1411 "associated with that religious or semi-religious superstition that these "
1412 "spirits are of supra-human origin and possess certain miraculous abilities by "
1413 "virtue of which they acquire their knowledge by quite other means than the rest "
1414 "of mankind. One ascribes to them, it seems, a direct view of the nature of the "
1415 "world, as it were a hole in the cloak of appearance, and believes that, by "
1416 "virtue of this miraculous seer's vision, they are able to communicate something "
1417 "conclusive and decisive about man and the world without the toil and "
1418 "rigorousness required by science. As long as there continue to be those who "
1419 "believe in the miraculous in the domain of knowledge one can perhaps concede "
1420 "that these people themselves derive some benefit from their belief, inasmuch as "
1421 "through their unconditional subjection to the great spirits they create for "
1422 "their own spirit during its time of development the finest form of discipline "
1423 "and schooling. On the other hand, it is at least questionable whether the "
1424 "superstitious belief in genius, in its privileges and special abilities, is of "
1425 "benefit to the genius himself if it takes root in him. It is in any event a "
1426 "dangerous sign when a man is assailed by awe of himself, whether it be the "
1427 "celebrated Caesar's awe of Caesar or the awe of one's own genius now under "
1428 "consideration; when the sacrificial incense which is properly rendered only to "
1429 "a god penetrates the brain of the genius, so that his head begins to swim and "
1430 "he comes to regard himself as something supra-human. The consequences that "
1431 "slowly result are: the feeling of irresponsibility, of exceptional rights, the "
1432 "belief that he confers a favor by his mere presence, insane rage when anyone "
1433 "attempts even to compare him with others, let alone to rate him beneath them, "
1434 "or to draw attention to lapses in his work. Because he ceases to practice "
1435 "criticism of himself, at last one pinion after the other falls out of his "
1436 "plumage: that superstitious eats at the roots of his powers and perhaps even "
1437 "turns him into a hypocrite after his powers have fled from him. For the great "
1438 "spirits themselves it is therefore probably more beneficial if they acquire an "
1439 "insight into the nature and origin of their powers, if they grasp, that is to "
1440 "say, what purely human qualities have come together in them and what fortunate "
1441 "circumstances attended them: in the first place undiminished energy, resolute "
1442 "application to individual goals, great personal courage, then the good fortune "
1443 "to receive an upbringing which offered in the early years the finest teachers, "
1444 "models and methods. To be sure, when their goal is the production of the "
1445 "greatest possible effect, unclarity with regard to oneself and that "
1446 "semi-insanity superadded to it has always achieved much; for what has been "
1447 "admired and envied at all times has been that power in them by virtue of which "
1448 "they render men will-less and sweep them away into the delusion that the "
1449 "leaders they are following are supra-natural. Indeed, it elevates and inspires "
1450 "men to believe that someone is in possession of supra-natural powers: to this "
1451 "extent Plato was right to say [Plato: Phaedrus, 244a] that madness has brought "
1452 "the greatest of blessings upon mankind. In rare individual cases this portion "
1453 "of madness may, indeed, actually have been the means by which such a nature, "
1454 "excessive in all directions, was held firmly together: in the life of "
1455 "individuals, too, illusions that are in themselves poisons often play the role "
1456 "of healers; yet, in the end, in the case of every \"genius\" who believes in his "
1457 "own divinity the poison shows itself to the same degree as his \"genius\" grows "
1458 "old: one may recall, for example, the case of Napoleon, whose nature certainly "
1459 "grew into the mighty unity that sets him apart from all men of modern times "
1460 "precisely through his belief in himself and his star and through the contempt "
1461 "for men that flowed from it; until in the end, however, this same belief went "
1462 "over into an almost insane fatalism, robbed him of his acuteness and swiftness "
1463 "of perception, and became the cause of his destruction.";