PCL
|
Client-side interface to a PixInsight ScrollBox control. More...
#include <ScrollBox.h>
Public Types | |
using | pos_event_handler = void(Control::*)(ScrollBox &sender, int pos) |
using | range_event_handler = void(Control::*)(ScrollBox &sender, int minValue, int maxValue) |
Public Types inherited from pcl::Frame | |
using | style = FrameStyle::value_type |
Public Types inherited from pcl::Control | |
using | child_event_handler = void(Control::*)(Control &sender, Control &child) |
using | close_event_handler = void(Control::*)(Control &sender, bool &allowClose) |
using | event_handler = void(Control::*)(Control &sender) |
using | file_drag_event_handler = void(Control::*)(Control &sender, const pcl::Point &pos, const StringList &files, unsigned modifiers, bool &wantsFiles) |
using | file_drop_event_handler = void(Control::*)(Control &sender, const pcl::Point &pos, const StringList &files, unsigned modifiers) |
using | keyboard_event_handler = void(Control::*)(Control &sender, int key, unsigned modifiers, bool &wantsKey) |
using | mouse_button_event_handler = void(Control::*)(Control &sender, const pcl::Point &pos, int button, unsigned buttons, unsigned modifiers) |
using | mouse_event_handler = void(Control::*)(Control &sender, const pcl::Point &pos, unsigned buttons, unsigned modifiers) |
using | mouse_wheel_event_handler = void(Control::*)(Control &sender, const pcl::Point &pos, int delta, unsigned buttons, unsigned modifiers) |
using | move_event_handler = void(Control::*)(Control &sender, const pcl::Point &newPos, const pcl::Point &oldPos) |
using | paint_event_handler = void(Control::*)(Control &sender, const pcl::Rect &updateRect) |
using | resize_event_handler = void(Control::*)(Control &sender, int newWidth, int newHeight, int oldWidth, int oldHeight) |
using | view_drag_event_handler = void(Control::*)(Control &sender, const pcl::Point &pos, const View &view, unsigned modifiers, bool &wantsView) |
using | view_drop_event_handler = void(Control::*)(Control &sender, const pcl::Point &pos, const View &view, unsigned modifiers) |
Additional Inherited Members | |
Static Public Member Functions inherited from pcl::Control | |
static void | HideToolTip () |
static Control & | Null () |
static void | ShowToolTip (const Point &pos, const String &text, const Control &control=Control::Null(), const Rect &rect=Rect(0)) |
static void | ShowToolTip (int x, int y, const String &text, const Control &control=Control::Null(), const Rect &rect=Rect(0)) |
static String | ToolTipText () |
Static Public Member Functions inherited from pcl::UIObject | |
static UIObject & | Null () |
Protected Member Functions inherited from pcl::UIObject | |
UIObject ()=default | |
UIObject (const UIObject &x) | |
UIObject (UIObject &&x) | |
UIObject & | operator= (const UIObject &x) |
UIObject & | operator= (UIObject &&x) |
Definition at line 75 of file ScrollBox.h.
pcl::ScrollBox::ScrollBox | ( | Control & | parent = Control::Null() | ) |
Constructs a ScrollBox as a child control of parent.
|
inlineoverride |
Destroys a ScrollBox control.
Definition at line 87 of file ScrollBox.h.
|
inline |
Disables the automatic scroll mode.
This is a convenience member function, equivalent to EnableAutoScroll( !disableHorz, !disableVert )
Definition at line 204 of file ScrollBox.h.
|
inline |
Disables or enables the automatic tracking mode for the horizontal scroll bar of this box control control.
This is a convenience member function, equivalent to EnableTracking( !disableHorz, IsVerticalTrackingEnabled() )
Definition at line 490 of file ScrollBox.h.
|
inline |
Disables or enables the automatic tracking mode for this scroll box control.
This is a convenience member function, equivalent to EnableTracking( !disableHorz, !disableVert )
Definition at line 478 of file ScrollBox.h.
|
inline |
Disables or enables the automatic tracking mode for the vertical scroll bar of this box control control.
This is a convenience member function, equivalent to EnableTracking( IsHorizontalTrackingEnabled(), !disableVert )
Definition at line 502 of file ScrollBox.h.
void pcl::ScrollBox::EnableAutoScroll | ( | bool | enableHorz = true , |
bool | enableVert = true |
||
) |
Enables the automatic scroll mode.
enableHorz | New enabled state for the horizontal scroll bar. |
enableVert | New enabled state for the vertical scroll bar. |
In automatic scroll mode, scroll bars are automatically shown or hidden as necessary. A scroll bar is shown only if the corresponding scrolling range is larger than the visible length of the scrolling area.
|
inline |
Enables or disables the automatic tracking mode for the horizontal scroll bar of this box control control.
This is a convenience member function, equivalent to EnableTracking( enableHorz, IsVerticalTrackingEnabled() )
Definition at line 454 of file ScrollBox.h.
void pcl::ScrollBox::EnableTracking | ( | bool | enableHorz = true , |
bool | enableVert = true |
||
) |
Enables or disables the automatic tracking mode for this scroll box control.
enableHorz | New state of automatic tracking mode for the horizontal scroll bar. |
enableVert | New state of automatic tracking mode for the vertical scroll bar. |
When automatic tracking is enabled, the viewport receives continuous update requests while the user is moving an scroll bar with the mouse. When automatic tracking is disabled, the viewport is updated only when the mouse is released.
|
inline |
Enables or disables the automatic tracking mode for the vertical scroll bar of this box control control.
This is a convenience member function, equivalent to EnableTracking( IsHorizontalTrackingEnabled(), enableVert )
Definition at line 466 of file ScrollBox.h.
void pcl::ScrollBox::GetHorizontalScrollRange | ( | int & | minPos, |
int & | maxPos | ||
) | const |
Gets the current horizontal scroll range.
[out] | minPos | Minimum horizontal scrolling position |
[out] | maxPos | Maximum horizontal scrolling position |
The virtual document width is equal to maxPos - minPos + PageWidth() in scrolling units.
void pcl::ScrollBox::GetVerticalScrollRange | ( | int & | minPos, |
int & | maxPos | ||
) | const |
Gets the current vertical scroll range.
[out] | minPos | Minimum vertical scrolling position |
[out] | maxPos | Maximum vertical scrolling position |
The virtual document height is equal to maxPos - minPos + PageHeight() in scrolling units.
|
inline |
Forces visibility of the horizontal scroll bar.
This is a convenience member function, equivalent to ShowHorizontalScrollBar( !hide )
Definition at line 139 of file ScrollBox.h.
|
inline |
Forces visibility of scroll bars.
This is a convenience member function, equivalent to ShowScrollBars( !hideHorz, !hideVert )
Definition at line 117 of file ScrollBox.h.
|
inline |
Forces visibility of the vertical scroll bar.
This is a convenience member function, equivalent to ShowVerticalScrollBar( !hide )
Definition at line 161 of file ScrollBox.h.
|
inline |
Returns the current horizontal scroll position in scrolling units.
Definition at line 375 of file ScrollBox.h.
References pcl::GenericPoint< T >::x.
bool pcl::ScrollBox::IsHorizontalAutoScrollEnabled | ( | ) | const |
Returns true iff the automatic scroll mode is enabled for the horizontal scroll bar.
In automatic scroll mode, scroll bars are automatically shown or hidden as necessary. A scroll bar is shown only if the corresponding scrolling range is larger than the visible length of the scrolling area.
bool pcl::ScrollBox::IsHorizontalScrollBarVisible | ( | ) | const |
Returns true iff the horizontal scroll bar is currently visible on this scroll box.
bool pcl::ScrollBox::IsHorizontalTrackingEnabled | ( | ) | const |
Returns true iff the automatic tracking mode is enabled for the horizontal scroll bar of this scroll box control.
bool pcl::ScrollBox::IsVerticalAutoScrollEnabled | ( | ) | const |
Returns true iff the automatic scroll mode is enabled for the vertical scroll bar.
In automatic scroll mode, scroll bars are automatically shown or hidden as necessary. A scroll bar is shown only if the corresponding scrolling range is larger than the visible length of the scrolling area.
bool pcl::ScrollBox::IsVerticalScrollBarVisible | ( | ) | const |
Returns true iff the vertical scroll bar is currently visible on this scroll box.
bool pcl::ScrollBox::IsVerticalTrackingEnabled | ( | ) | const |
Returns true iff the automatic tracking mode is enabled for the vertical scroll bar of this scroll box control.
int pcl::ScrollBox::LineHeight | ( | ) | const |
Returns the current line height of this scroll box control.
The line height is the number of scrolling units scrolled when the user clicks on an arrow icon of the vertical scroll bar.
int pcl::ScrollBox::LineWidth | ( | ) | const |
Returns the current line width of this scroll box control.
The line width is the number of scrolling units scrolled when the user clicks on an arrow icon of the horizontal scroll bar.
|
inline |
Returns the maximum horizontal scrolling position.
Definition at line 242 of file ScrollBox.h.
|
inline |
Returns the maximum horizontal scrolling position.
Definition at line 258 of file ScrollBox.h.
|
inline |
Returns the minimum horizontal scrolling position.
Definition at line 234 of file ScrollBox.h.
|
inline |
Returns the minimum vertical scrolling position.
Definition at line 250 of file ScrollBox.h.
int pcl::ScrollBox::PageHeight | ( | ) | const |
Returns the current page height of this scroll box in scrolling units.
The page height is the length of the vertical scroll bar's slider, or the amount scrolled when the user presses the PgUp or PgDn keys.
int pcl::ScrollBox::PageWidth | ( | ) | const |
Returns the current page width of this scroll box in scrolling units.
The page width is the length of the horizontal scroll bar's slider.
pcl::Point pcl::ScrollBox::ScrollPosition | ( | ) | const |
Returns the current scroll position. Returned oordinates are expressed in scrolling units.
|
inline |
Sets the horizontal scroll position.
Definition at line 405 of file ScrollBox.h.
void pcl::ScrollBox::SetHorizontalScrollRange | ( | int | minPos, |
int | maxPos | ||
) |
Sets the horizontal scroll range.
minPos | Minimum horizontal scrolling position |
maxPos | Maximum horizontal scrolling position |
The virtual document width will be equal to maxPos - minPos + PageWidth() in scrolling units.
|
inline |
Sets the line height of this scroll box in scrolling units.
Definition at line 361 of file ScrollBox.h.
void pcl::ScrollBox::SetLineSize | ( | int | width, |
int | height | ||
) |
Sets the line sizes of this scroll box.
width | New line width in scrolling units. |
height | New line height in scrolling units. |
|
inline |
Sets the line width of this scroll box in scrolling units.
Definition at line 353 of file ScrollBox.h.
|
inline |
Sets the page height of this scroll box in scrolling units.
Definition at line 321 of file ScrollBox.h.
void pcl::ScrollBox::SetPageSize | ( | int | width, |
int | height | ||
) |
Sets the page size of this scroll box.
width | New page width in scrolling units. |
height | New page height in scrolling units. |
|
inline |
Sets the page width of this scroll box in scrolling units.
Definition at line 313 of file ScrollBox.h.
|
inline |
Sets the scroll position pos of this scroll box control.
Definition at line 391 of file ScrollBox.h.
References pcl::GenericPoint< T >::x, and pcl::GenericPoint< T >::y.
void pcl::ScrollBox::SetScrollPosition | ( | int | horzPos, |
int | vertPos | ||
) |
Sets the scroll coordinates horzPos and vertPos of this scroll box control.
|
inline |
Sets the vertical scroll position.
Definition at line 413 of file ScrollBox.h.
void pcl::ScrollBox::SetVerticalScrollRange | ( | int | minPos, |
int | maxPos | ||
) |
Sets the vertical scroll range.
minPos | Minimum vertical scrolling position |
maxPos | Maximum vertical scrolling position |
The virtual document height will be equal to maxPos - minPos + PageHeight() in scrolling units.
|
inline |
Forces visibility of the horizontal scroll bar.
This is a convenience member function, equivalent to ShowScrollBars( show, IsVerticalScrollBarVisible() )
Definition at line 128 of file ScrollBox.h.
void pcl::ScrollBox::ShowScrollBars | ( | bool | showHorz = true , |
bool | showVert = true |
||
) |
Forces visibility of scroll bars.
showHorz | Visibility of the horizontal scroll bar. |
showVert | Visibility of the vertical scroll bar. |
|
inline |
Forces visibility of the vertical scroll bar.
This is a convenience member function, equivalent to ShowScrollBars( IsHorizontalScrollBarVisible(), show )
Definition at line 150 of file ScrollBox.h.
|
inline |
Returns the current vertical scroll position in scrolling units.
Definition at line 383 of file ScrollBox.h.
References pcl::GenericPoint< T >::y.
|
inline |
Returns a reference to the viewport control of this scroll box.
The viewport control represents the contents, or "virtual document" of the scroll box.
Definition at line 525 of file ScrollBox.h.
|
inline |
Returns a constant reference to the viewport control of this scroll box.
The viewport control represents the contents, or "virtual document" of the scroll box.
Definition at line 514 of file ScrollBox.h.