Version: 2.9.4
Public Member Functions
wxScrollBar Class Reference

#include </home/zeitlin/src/wx/github/interface/wx/scrolbar.h>

Inheritance diagram for wxScrollBar:

Detailed Description

A wxScrollBar is a control that represents a horizontal or vertical scrollbar.

It is distinct from the two scrollbars that some windows provide automatically, but the two types of scrollbar share the way events are received.

注意:
A scrollbar has the following main attributes: range, thumb size, page size, and position. The range is the total number of units associated with the view represented by the scrollbar. For a table with 15 columns, the range would be 15. The thumb size is the number of units that are currently visible. For the table example, the window might be sized so that only 5 columns are currently visible, in which case the application would set the thumb size to 5. When the thumb size becomes the same as or greater than the range, the scrollbar will be automatically hidden on most platforms. The page size is the number of units that the scrollbar should scroll by, when 'paging' through the data. This value is normally the same as the thumb size length, because it is natural to assume that the visible window size defines a page. The scrollbar position is the current thumb position. Most applications will find it convenient to provide a function called AdjustScrollbars() which can be called initially, from an OnSize event handler, and whenever the application data changes in size. It will adjust the view, object and page size according to the size of the window and the size of the data.

Styles

This class supports the following styles:

Events emitted by this class

The following event handler macros redirect the events to member function handlers 'func' with prototypes like:

void handlerFuncName(wxScrollEvent& event)

Event macros for events emitted by this class:

You can use EVT_COMMAND_SCROLL... macros with window IDs for when intercepting scroll events from controls, or EVT_SCROLL... macros without window IDs for intercepting scroll events from the receiving window -- except for this, the macros behave exactly the same.

The difference between EVT_SCROLL_THUMBRELEASE and EVT_SCROLL_CHANGED

The EVT_SCROLL_THUMBRELEASE event is only emitted when actually dragging the thumb using the mouse and releasing it (This EVT_SCROLL_THUMBRELEASE event is also followed by an EVT_SCROLL_CHANGED event).

The EVT_SCROLL_CHANGED event also occurs when using the keyboard to change the thumb position, and when clicking next to the thumb (In all these cases the EVT_SCROLL_THUMBRELEASE event does not happen).

In short, the EVT_SCROLL_CHANGED event is triggered when scrolling/moving has finished independently of the way it had started. Please see the widgets sample ("Slider" page) to see the difference between EVT_SCROLL_THUMBRELEASE and EVT_SCROLL_CHANGED in action.

Library:  wxCore
Category:  Controls

Appearance:
wxMSW appearancewxGTK appearancewxMac appearance
wxMSW appearancewxGTK appearancewxMac appearance
参照:
Scrolled Windows, Events and Event Handling, wxScrolled

Public Member Functions

 wxScrollBar ()
 Default constructor.
 wxScrollBar (wxWindow *parent, wxWindowID id, const wxPoint &pos=wxDefaultPosition, const wxSize &size=wxDefaultSize, long style=wxSB_HORIZONTAL, const wxValidator &validator=wxDefaultValidator, const wxString &name=wxScrollBarNameStr)
 Constructor, creating and showing a scrollbar.
virtual ~wxScrollBar ()
 Destructor, destroying the scrollbar.
bool Create (wxWindow *parent, wxWindowID id, const wxPoint &pos=wxDefaultPosition, const wxSize &size=wxDefaultSize, long style=wxSB_HORIZONTAL, const wxValidator &validator=wxDefaultValidator, const wxString &name=wxScrollBarNameStr)
 Scrollbar creation function called by the scrollbar constructor.
virtual int GetPageSize () const
 Returns the page size of the scrollbar.
virtual int GetRange () const
 Returns the length of the scrollbar.
virtual int GetThumbPosition () const
 Returns the current position of the scrollbar thumb.
virtual int GetThumbSize () const
 Returns the thumb or 'view' size.
virtual void SetScrollbar (int position, int thumbSize, int range, int pageSize, bool refresh=true)
 Sets the scrollbar properties.
virtual void SetThumbPosition (int viewStart)
 Sets the position of the scrollbar.
bool IsVertical () const
 Returns true for scrollbars that have the vertical style set.

List of all members.


Constructor & Destructor Documentation

wxScrollBar::wxScrollBar ( )

Default constructor.

wxScrollBar::wxScrollBar ( wxWindow parent,
wxWindowID  id,
const wxPoint pos = wxDefaultPosition,
const wxSize size = wxDefaultSize,
long  style = wxSB_HORIZONTAL,
const wxValidator validator = wxDefaultValidator,
const wxString name = wxScrollBarNameStr 
)

Constructor, creating and showing a scrollbar.

Parameters:
parentParent window. Must be non-NULL.
idWindow identifier. The value wxID_ANY indicates a default value.
posWindow position. If wxDefaultPosition is specified then a default position is chosen.
sizeWindow size. If wxDefaultSize is specified then a default size is chosen.
styleWindow style. See wxScrollBar.
validatorWindow validator.
nameWindow name.
参照:
Create(), wxValidator
virtual wxScrollBar::~wxScrollBar ( ) [virtual]

Destructor, destroying the scrollbar.


Member Function Documentation

bool wxScrollBar::Create ( wxWindow parent,
wxWindowID  id,
const wxPoint pos = wxDefaultPosition,
const wxSize size = wxDefaultSize,
long  style = wxSB_HORIZONTAL,
const wxValidator validator = wxDefaultValidator,
const wxString name = wxScrollBarNameStr 
)

Scrollbar creation function called by the scrollbar constructor.

See wxScrollBar() for details.

Reimplemented from wxControl.

virtual int wxScrollBar::GetPageSize ( ) const [virtual]

Returns the page size of the scrollbar.

This is the number of scroll units that will be scrolled when the user pages up or down. Often it is the same as the thumb size.

参照:
SetScrollbar()
virtual int wxScrollBar::GetRange ( ) const [virtual]

Returns the length of the scrollbar.

参照:
SetScrollbar()
virtual int wxScrollBar::GetThumbPosition ( ) const [virtual]

Returns the current position of the scrollbar thumb.

参照:
SetThumbPosition()
virtual int wxScrollBar::GetThumbSize ( ) const [virtual]

Returns the thumb or 'view' size.

参照:
SetScrollbar()
bool wxScrollBar::IsVertical ( ) const

Returns true for scrollbars that have the vertical style set.

virtual void wxScrollBar::SetScrollbar ( int  position,
int  thumbSize,
int  range,
int  pageSize,
bool  refresh = true 
) [virtual]

Sets the scrollbar properties.

Parameters:
positionThe position of the scrollbar in scroll units.
thumbSizeThe size of the thumb, or visible portion of the scrollbar, in scroll units.
rangeThe maximum position of the scrollbar.
pageSizeThe size of the page size in scroll units. This is the number of units the scrollbar will scroll when it is paged up or down. Often it is the same as the thumb size.
refreshtrue to redraw the scrollbar, false otherwise.
注意:
Let's say you wish to display 50 lines of text, using the same font. The window is sized so that you can only see 16 lines at a time. You would use:
            scrollbar->SetScrollbar(0, 16, 50, 15);
The page size is 1 less than the thumb size so that the last line of the previous page will be visible on the next page, to help orient the user. Note that with the window at this size, the thumb position can never go above 50 minus 16, or 34. You can determine how many lines are currently visible by dividing the current view size by the character height in pixels. When defining your own scrollbar behaviour, you will always need to recalculate the scrollbar settings when the window size changes. You could therefore put your scrollbar calculations and SetScrollbar() call into a function named AdjustScrollbars, which can be called initially and also from a wxSizeEvent event handler function.

Reimplemented from wxWindow.

virtual void wxScrollBar::SetThumbPosition ( int  viewStart) [virtual]

Sets the position of the scrollbar.

Parameters:
viewStartThe position of the scrollbar thumb.
参照:
GetThumbPosition()
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Friends Defines