Inheritance diagram

Collaboration diagram

Description

How to use

SFYScrollBarControl is the abstract base class for all scroll bar controls.

In a SFYScrollBarControl, functions to draw a track, increment/decrement arrow, or thumb label and display the scrolling status are implemented by default. Several handlers with default behaviour are also implemented as virtual functions.

The below is the layout of scroll bar control.

The design of scroll bar control can be changed using the functions such as SFYScrollBarControl::SetBevelColor, SFYScrollBarControl::SetTrackColor, or SFYScrollBarControl::SetArrowColor.

The horizontal or vertical orientation of scroll bar can be switched with the SFYScrollBarControl::SetOrientation function.

Events and their handlers

	Note
	*1. Execute SFYResponder::SetVirtualBound (SFXRectangle(SFXGrid::ZeroInstance(), GetRealBound().GetSize())).

Reference

SFYControl | SFZScrollBarControl | SFYScrollBarControl::SetBevelColor | SFYScrollBarControl::SetTrackColor | SFYScrollBarControl::SetArrowColor | SFYScrollBarControl::SetOrientation

Member

Description

This constructor performs the initializations as follows:

	Note
	In a responder inheriting from SFYScrollBarControl, the corresponding handler will be called when one of the above events occurs.

Internal Implementation

Internal implementation of this constructor is as follows:

/*public */SFYScrollBarControl::SFYScrollBarControl(Void) static_throws
{
    static SFXEventRange::AtomRecConst          range[] = {
        { SFEVT_RESPONDER_VALUE,  SFEVT_RESPONDER_VALUE,  SFP16_VALUE_MAXIMUM,  SFP16_VALUE_CURRENT}
    };
    SFYHandler::RuleRec                         rule[lengthof(range)];

    if (static_try()) {
        SetType(CODE_TYPE);
        rule[0].spp = XANDLER_FUNCTION(OnValue);
        rule[0].reference = this;
        static_throw(RegisterHandler(atomic_cast(range), rule, lengthof(range)));
        if (static_try()) {
            static SFXRGBColor::AtomRecConst    theme[] = {
                {{{0x00, 0xFF, 0xFF, 0xFF}}},
                {{{0x00, 0xCC, 0xCC, 0xCC}}},
                {{{0x00, 0x88, 0x88, 0x88}}},
                {{{0x00, 0xF0, 0xF0, 0xF0}}},
                {{{0x00, 0x00, 0x00, 0x00}}}
            };
            _color.bevel.Set(theme[0], theme[1], theme[2]);
            _color.track.Set(theme[3]);
            _color.arrow.Set(theme[4]);
            SetMinimumValue(0);
            SetMaximumValue(0);
            SetCurrentValue(0);
            _pagesize = 0;
            _scrollstep = 0;
            _scrollbar.orient = DEFAULT_ORIENTATION;
            _scrollbar.thumbTop = 0;
            _scrollbar.thumbLength = 0;
            _scrollbar.scrollRange = 0;
            _scrollable = false;
        }
    }
}// SFYScrollBarControl::SFYScrollBarControl //

/*private */XANDLER_IMPLEMENT_VOIDVALUE(SFYScrollBarControl, OnValue, invoker, reason, value)
{
    unused(invoker); unused(value);
    switch (reason) {
        case SFP16_VALUE_MAXIMUM:
        case SFP16_VALUE_MINIMUM:
            QueryScrollable();
            RelocateThumb();
            break;
        case SFP16_VALUE_CURRENT:
            RelocateThumbTop();
            break;
        default:
            break;
    }
    Invalidate();
    return;
}// XANDLER_IMPLEMENT_VOIDSTATE(SFYScrollBarControl, OnValue) //

/*private */Void SFYScrollBarControl::QueryScrollable(Void)
{
    SInt32Const                                 min(GetMinimumValue());
    SInt32Const                                 max(GetMaximumValue());

    if (((max > min) && (max - min > _pagesize)) ^ !(!_scrollable)) {
        _scrollable = !_scrollable;
        HandleScrollable();
    }
    return;
}// SFYScrollBarControl::QueryScrollable //

/*protected virtual */Void SFYScrollBarControl::HandleScrollable(Void)
{
    InvokeBackward(SFXEvent(SFEVT_RESPONDER_SCROLLBAR, SFP16_SCROLLBAR_ENABLE, 0), true);
    return;
}// SFYScrollBarControl::HandleScrollable //

/*private */Void SFYScrollBarControl::RelocateThumb(Void)
{
    if (IsScrollable()) {
        RelocateThumbLength();
        RelocateThumbTop();
    }
    else {
        _scrollbar.thumbLength = 0;
    }
    return;
}// SFYScrollBarControl::RelocateThumb //

/*private */Void SFYScrollBarControl::RelocateThumbLength(Void)
{
    SInt32Const                                 min(GetMinimumValue());
    SInt32Const                                 max(GetMaximumValue());
    SFXRectangleConst                           rc(GetLocalBound());
    SInt16                                      track;

    track = (_scrollbar.orient == VERTICAL) ? _track.GetHeight() : _track.GetWidth();
    track = (track > 0) ? track : 0;
    _scrollbar.thumbLength = static_cast<SInt16>(track * _pagesize / (max - min));
    if ((_scrollbar.thumbLength < MINIMUM_THUMB_LENGTH) && (MINIMUM_THUMB_LENGTH < track)) {
        _scrollbar.thumbLength = MINIMUM_THUMB_LENGTH;
    }
    _scrollbar.scrollRange = track - _scrollbar.thumbLength;
    return;
}// SFYScrollBarControl::RelocateThumbLength //

/*private */ Void SFYScrollBarControl::RelocateThumbTop(Void)
{
    SInt32Const                                 cur(GetCurrentValue());
    SInt32Const                                 min(GetMinimumValue());
    SInt32Const                                 max(GetMaximumValue());

    if (max - min > _pagesize) { // This is always true. //
        _scrollbar.thumbTop = static_cast<SInt16>(_scrollbar.scrollRange * (cur - min) / (max - min - _pagesize));
    }
    else {
        _scrollbar.thumbTop = 0;
    }
    return;
}// SFYScrollBarControl::RelocateThumbTop //

Reference

SFYResponder::SetType | SFYScrollBarControl::CodeEnum | SFYScrollBarControl::SetBevelColor | SFYScrollBarControl::SetTrackColor | SFYScrollBarControl::SetArrowColor | SFYScrollBarControl::SetPageValue | SFYScrollBarControl::SetScrollStepValue | SFYScrollBarControl::SetOrientation | SFYScrollBarControl::OrientationEnum | SFYScrollBarControl::GetThumbTop | SFYScrollBarControl::GetThumbLength | SFYScrollBarControl::GetScrollRange | SFYScrollBarControl::IsScrollable | SFYScrollBarControl::HandleScrollable | SFYControl::SetMinimumValue | SFYControl::SetMaximumValue | SFYControl::SetCurrentValue | SFXBevelColor | SFXRGBColor | SFXEvent | Type | State | Event | Value Event[SFEVT_RESPONDER_VALUE]

Description

This destructor does nothing.

Description

This function decrements the current value of this scroll bar control by the value of scroll step set with the SFYScrollBarControl::SetScrollStepValue function.

Reference

SFYScrollBarControl::SetScrollStepValue | SFYScrollBarControl::Increment

Description

This function draws the "decrement arrow" label of this scroll bar control.

In case you want to perform your own processing, override this function.

	Tip
	This function will be called in the SFZScrollBarControl::HandleRenderRequest function.

Internal Implementation

Internal implementation of the SFYScrollBarControl::DrawDecrement function is as follows:

enum {
        MINIMUM_THUMB_LENGTH             = 2,
        MINIMUM_MINOR_AXIS_SIZE          = 2,
        INACTIVE_ARROW                   = 0x66
};

/*protected */Void SFYScrollBarControl::DrawDecrement(SFXGraphicsPtr graphics) const
{
    SFXRGBColor                                 arrow(GetArrowColor());
    SFXBevelColor                               bevel(GetBevelColor());
    SFXRectangleConstRef                        rc(GetDecrementArrowRectangle());

    if (!rc.IsEmpty()) {
        if (!GetStateActive(true) || !IsScrollable()) {
            bevel.SetDark(bevel.GetBase());
            bevel.SetLight(bevel.GetBase());
            (arrow.GetBrightness() > 0x7F) ? arrow.SubRGB(INACTIVE_ARROW) : arrow.AddRGB(INACTIVE_ARROW);
        }
        if (GetOrientation() == VERTICAL) {
            graphics->FillBevelRectangle(rc, bevel);
            graphics->FillTriangle(CalculateTriangle(rc, SCROLL_UP), arrow);
        }
        else {
            graphics->FillBevelRectangle(rc, bevel);
            graphics->FillTriangle(CalculateTriangle(rc, SCROLL_LEFT), arrow);
        }
    }
    return;
}// SFYScrollBarControl::DrawDecrement

/*private */SFXTriangle SFYScrollBarControl::CalculateTriangle(SFXRectangleConstRef rect, ScrollDirectionEnum direction) const
{
    SInt16                                      w;
    SInt16                                      h;
    SFXRectangle                                temp(rect);

    if (direction == SCROLL_UP || direction == SCROLL_DOWN) {
        h = rect.GetHeight() / 4;
        w = h * 2;
    }
    else {
        w = rect.GetWidth() / 4;
        h = w * 2;
    }
    temp.SetSize(w, h);
    temp.Offset((rect.GetWidth() - w - 1) / 2, (rect.GetHeight() - h - 1) / 2);
    return InscribedTriangle(temp, direction);
}// SFZSoftKeyControl::CalculateTriangle //

/*private */SFXTriangle SFYScrollBarControl::InscribedTriangle(SFXRectangleConstRef rect, ScrollDirectionEnum direction) const
{
    SFXTriangle                                 result;
    SInt16                                      x(rect.GetX());
    SInt16                                      y(rect.GetY());
    SInt16                                      w(rect.GetWidth());
    SInt16                                      h(rect.GetHeight());

    switch (direction) {
        case SCROLL_UP:
            result.Set(x + w / 2, y, x, y + h, x + w, y + h);
            break;
        case SCROLL_DOWN:
            result.Set(x, y, x + w, y, x + w / 2, y + h);
            break;
        case SCROLL_LEFT:
            result.Set(x + w, y, x, y + h / 2, x + w, y + h);
            break;
        case SCROLL_RIGHT:
            result.Set(x, y, x, y + h, x + w, y + h / 2);
            break;
    }
    return result;
}// SFYScrollBarControl::InscribedTriangle //

Reference

SFZScrollBarControl::HandleRenderRequest | SFYScrollBarControl::DrawTrack | SFYScrollBarControl::DrawIncrement | SFYScrollBarControl::DrawThumb

Description

This function draws the "increment arrow" label of this scroll bar control.

In case you want to perform your own processing, override this function.

	Tip
	This function will be called in the SFZScrollBarControl::HandleRenderRequest function.

Internal Implementation

Internal implementation of the SFYWidget::HandleBoundOptimize function is as follows:

enum {
        MINIMUM_THUMB_LENGTH             = 2,
        MINIMUM_MINOR_AXIS_SIZE          = 2,
        INACTIVE_ARROW                   = 0x66
};

/*protected */Void SFYScrollBarControl::DrawIncrement(SFXGraphicsPtr graphics) const
{
    SFXRGBColor                                 arrow(GetArrowColor());
    SFXBevelColor                               bevel(GetBevelColor());
    SFXRectangleConstRef                        rc(GetIncrementArrowRectangle());

    if (!rc.IsEmpty()) {
        if (!GetStateActive(true) || !IsScrollable()) {
            bevel.SetDark(bevel.GetBase());
            bevel.SetLight(bevel.GetBase());
            (arrow.GetBrightness() > 0x7F) ? arrow.SubRGB(INACTIVE_ARROW) : arrow.AddRGB(INACTIVE_ARROW);
        }
        if (GetOrientation() == VERTICAL) {
            graphics->FillBevelRectangle(rc, bevel);
            graphics->FillTriangle(CalculateTriangle(rc, SCROLL_DOWN), arrow);
        }
        else {
            graphics->FillBevelRectangle(rc, bevel);
            graphics->FillTriangle(CalculateTriangle(rc, SCROLL_RIGHT), arrow);
        }
    }
    return;
}// SFYScrollBarControl::DrawIncrement //

/*private */SFXTriangle SFYScrollBarControl::CalculateTriangle(SFXRectangleConstRef rect, ScrollDirectionEnum direction) const
{
    SInt16                                      w;
    SInt16                                      h;
    SFXRectangle                                temp(rect);

    if (direction == SCROLL_UP || direction == SCROLL_DOWN) {
        h = rect.GetHeight() / 4;
        w = h * 2;
    }
    else {
        w = rect.GetWidth() / 4;
        h = w * 2;
    }
    temp.SetSize(w, h);
    temp.Offset((rect.GetWidth() - w - 1) / 2, (rect.GetHeight() - h - 1) / 2);
    return InscribedTriangle(temp, direction);
}// SFZSoftKeyControl::CalculateTriangle //

/*private */SFXTriangle SFYScrollBarControl::InscribedTriangle(SFXRectangleConstRef rect, ScrollDirectionEnum direction) const
{
    SFXTriangle                                 result;
    SInt16                                      x(rect.GetX());
    SInt16                                      y(rect.GetY());
    SInt16                                      w(rect.GetWidth());
    SInt16                                      h(rect.GetHeight());

    switch (direction) {
        case SCROLL_UP:
            result.Set(x + w / 2, y, x, y + h, x + w, y + h);
            break;
        case SCROLL_DOWN:
            result.Set(x, y, x + w, y, x + w / 2, y + h);
            break;
        case SCROLL_LEFT:
            result.Set(x + w, y, x, y + h / 2, x + w, y + h);
            break;
        case SCROLL_RIGHT:
            result.Set(x, y, x, y + h, x + w, y + h / 2);
            break;
    }
    return result;
}// SFYScrollBarControl::InscribedTriangle //

Reference

SFZScrollBarControl::HandleRenderRequest | SFYScrollBarControl::DrawTrack | SFYScrollBarControl::DrawDecrement | SFYScrollBarControl::DrawThumb

Description

This function draws the "thumb" label of this scroll bar control.

In case you want to perform your own processing, override this function.

	Tip
	This function will be called in the SFZScrollBarControl::HandleRenderRequest function.

Internal Implementation

Internal implementation of the SFYScrollBarControl::DrawThumb function is as follows:

/*protected */Void SFYScrollBarControl::DrawThumb(SFXGraphicsPtr graphics) const
{
    SFXBevelColor                               bevel(GetBevelColor());

    if (IsScrollable()) {
        if (!GetStateActive(true)) {
            bevel.SetDark(bevel.GetBase());
            bevel.SetLight(bevel.GetBase());
        }
        graphics->FillBevelRectangle(GetThumbRectangle(), bevel);
    }
    return;
}// SFYScrollBarControl::DrawThumb

Reference

SFZScrollBarControl::HandleRenderRequest | SFYScrollBarControl::DrawTrack | SFYScrollBarControl::DrawDecrement | SFYScrollBarControl::DrawIncrement

Description

This function draws the track(strictly, all the region of this scroll bar control) of this scroll bar control.

This function is used to fill the background of scroll bar control.

In case you want to perform your own processing, override this function.

	Tip
	This function will be called in the SFZScrollBarControl::HandleRenderRequest function.

Internal Implementation

Internal implementation of the SFYScrollBarControl::DrawTrack function is as follows:

/*protected */Void SFYScrollBarControl::DrawTrack(SFXGraphicsPtr graphics) const
{
    graphics->FillRectangle(GetTrackRectangle(), GetTrackColor());
    return;
}// SFYScrollBarControl::DrawTrack //

Reference

SFZScrollBarControl::HandleRenderRequest | SFYScrollBarControl::DrawDecrement | SFYScrollBarControl::DrawIncrement | SFYScrollBarControl::DrawThumb

Return value

Color(SFXRGBColor) of the decrement or increment arrow(or triangle) of this scroll bar control.

Description

This function gets the color(SFXRGBColor) of the decrement or increment arrow(or triangle) of this scroll bar control.

Reference

SFYScrollBarControl::SetArrowColor | SFXRGBColor

Return value

Bevel color(SFXBevelColor) to draw the outer frame of this scroll bar control.

Description

This function gets the bevel color to draw the outer frame of this scroll bar control.

Reference

SFYScrollBarControl::SetBevelColor | SFXBevelColor

Description

This function gets the region for the "decrement arrow" label of this scroll bar control.

Reference

SFYScrollBarControl::SetDecrementArrowRectangle

Description

This function gets the region for the "increment arrow" label of this scroll bar control.

Reference

SFYScrollBarControl::SetIncrementArrowRectangle

Return value

Orientation of this scroll bar control(SFYScrollBarControl::HORIZONTAL or SFYScrollBarControl::VERTICAL).

Description

This function gets the value(horizontal or vertical) of orientation of this scroll bar control.

Reference

SFYScrollBarControl::SetOrientation | SFYScrollBarControl::OrientationEnum

Description

This function gets the page size of this scroll bar control.

The page size corresponds to the thumb length.

The actual thumb length can be obtained by calling the SFYScrollBarControl::GetThumbLength function.

Reference

SFYScrollBarControl::SetPageValue | SFYScrollBarControl::GetThumbLength

Description

This function gets the scroll range of this scroll bar control, which is the length of the region obtained by excluding the arrow labels and the thumb label from the track.

Return value

Value of the scroll step of this scroll bar control.

Description

This function gets the value of scroll step of this scroll bar control.

Reference

SFYScrollBarControl::SetScrollStepValue

Description

This function gets the length of the "thumb" label of this scroll bar control.

Description

This function gets the region for the "thumb" label of this scroll bar control.

Return value

Position of the thumb top of this scroll bar control. (Value of Y coordinate in case of the vertical orientation. Value of X coordinate in case of the horizontal orientation)

Description

This function gets the position of the thumb top of this scroll bar control.

In this case, the origin is the border between the decrement arrow and the track.

Return value

Color(SFXRGBColor) of track of this scroll bar control, in which color the rectangle for the track will be filled.

Description

This function gets the color(SFXRGBColor) of track of this scroll bar control, in which color the rectangle for the track will be filled.

Reference

SFYScrollBarControl::SetTrackColor | SFXRGBColor

Description

This function gets the region for the track of this scroll bar control.

Reference

SFYScrollBarControl::SetTrackRectangle

Description

This function will be called when the (SFEVT_RESPONDER_BOUND, SFP16_BOUND_VIRTUAL) event is received.

In case you want to perform your own processing when the virtual region is changed, override this virtual function.

The default implementation is to relocate this responder to fit into the new virtual region.

	Sending the (SFEVT_RESPONDER_BOUND, SFP16_BOUND_VIRTUAL) event
	The (SFEVT_RESPONDER_BOUND, SFP16_BOUND_VIRTUAL) event will occur when the virtual region is changed by calling the SFYResponder::SetRealBound or SFYResponder::SetVirtualBound function.

Another method when the virtual region is changed

Other than overriding this virtual function, it is possible to define and implement the handler for region event[XANDLER_DECLARE_VOIDBOUND], and register it into the responder. In the processing when the virtual region is updated, this virtual function is executed first, and next the handlers for region event are executed in the registered order. In almost all cases, the method to override this virtual function is adopted since defining, implementing and registering the handler for region event can be omitted.

Internal Implementation

Internal implementation of the SFYScrollBarControl::HandleBoundVirtual function is as follows:

enum {
        MINIMUM_THUMB_LENGTH             = 2,
        MINIMUM_MINOR_AXIS_SIZE          = 2,
        INACTIVE_ARROW                   = 0x66
};

/*protected virtual */Void SFYScrollBarControl::HandleBoundVirtual(Void)
{
    Relocate();
    return;
}// SFYScrollBarControl::HandleBoundVirtual //

/*private */Void SFYScrollBarControl::Relocate(Void)
{
    RelocateTrackAndArrow();
    RelocateThumb();
    return;
}// SFYScrollBarControl::Relocate //

/*private */Void SFYScrollBarControl::RelocateThumbLength(Void)
{
    SInt32Const                                 min(GetMinimumValue());
    SInt32Const                                 max(GetMaximumValue());
    SFXRectangleConst                           rc(GetLocalBound());
    SInt16                                      track;

    track = (_scrollbar.orient == VERTICAL) ? _track.GetHeight() : _track.GetWidth();
    track = (track > 0) ? track : 0;
    _scrollbar.thumbLength = static_cast<SInt16>(track * _pagesize / (max - min));
    if ((_scrollbar.thumbLength < MINIMUM_THUMB_LENGTH) && (MINIMUM_THUMB_LENGTH < track)) {
        _scrollbar.thumbLength = MINIMUM_THUMB_LENGTH;
    }
    _scrollbar.scrollRange = track - _scrollbar.thumbLength;
    return;
}// SFYScrollBarControl::RelocateThumbLength //

/*private */ Void SFYScrollBarControl::RelocateThumbTop(Void)
{
    SInt32Const                                 cur(GetCurrentValue());
    SInt32Const                                 min(GetMinimumValue());
    SInt32Const                                 max(GetMaximumValue());

    if (max - min > _pagesize) { // This is always true. //
        _scrollbar.thumbTop = static_cast<SInt16>(_scrollbar.scrollRange * (cur - min) / (max - min - _pagesize));
    }
    else {
        _scrollbar.thumbTop = 0;
    }
    return;
}// SFYScrollBarControl::RelocateThumbTop //

Reference

SFYResponder::SetRealBound | SFYResponder::SetVirtualBound | Region Event[SFEVT_RESPONDER_BOUND] | Handler for the Region Event[XANDLER_DECLARE_VOIDBOUND] | Virtual Region | Real Region | Local Region

Description

This function will be called when the scrollable status is changed.

In case you want to perform your own processing, override this function.

The default implementation is to send the scroll bar event [SFXEvent(SFEVT_RESPONDER_SCROLLBAR, SFP16_SCROLLBAR_ENABLE, 0)].

Internal Implementation

Internal implementation of the SFYScrollBarControl::HandleScrollable function is as follows:

/*protected virtual */Void SFYScrollBarControl::HandleScrollable(Void)
{
    InvokeBackward(SFXEvent(SFEVT_RESPONDER_SCROLLBAR, SFP16_SCROLLBAR_ENABLE, 0), true);
    return;
}// SFYScrollBarControl::HandleScrollable //

Reference

SFXEvent | Scroll Bar Event[SFEVT_RESPONDER_SCROLLBAR]

Description

This function increments the current value of this scroll bar control by the value of scroll step set with the SFYScrollBarControl::SetScrollStepValue function.

Reference

SFYScrollBarControl::SetScrollStepValue | SFYScrollBarControl::Decrement

Description

This function gets the value of the scrollable flag indicating whether or not the bound responder can be scrolled.

If the responder can be scrolled in the either direction, "true" will be returned. Otherwise "false" will be returned.

Description

This function relocates the regions for the track and the increment/decrement arrow of this scroll bar control.

In the default implementation, the regions for the decrement arrow, the track and the increment arrow are relocated in this order based on the local region and the orientation of this scroll bar control.

In the class of the scroll bar control, overriding the SFYScrollBarControl::HandleBoundVirtual function is not recommended. To change the size or position of the arrow label or track, override this function.

Default implementaion

Void SFYScrollBarControl::RelocateTrackAndArrow(Void)

    SFXRectangleConst                           rc(GetLocalBound());
    SInt16                                      side;

    if (GetOrientation() == VERTICAL) {
        side = rc.GetWidth();
 SetDecrementArrowRectangle(SFXRectangle(rc).SetHeight(side));
 SetTrackRectangle(SFXRectangle(rc).AddY(side).SubHeight(side + side);
 SetIncrementArrowRectangle(SFXRectangle(GetDecrementArrowRectangle()).AddY(GetTrackRectangle().GetHeight() + side));
    }
    else {
        side = rc.GetHeight();
 SetDecrementArrowRectangle(SFXRectangle(rc).SetWidth(side));
 SetTrackRectangle(SFXRectangle(rc).AddX(side).SubWidth(side + side);
 SetIncrementArrowRectangle(SFXRectangle(GetDecrementArrowRectangle()).AddX(GetTrackRectangle().GetWidth() + side));
    }
    return;
}

Reference

SFYScrollBarControl::SetOrientation | SFYScrollBarControl::HandleBoundVirtual | Local Region

Description

This function sets the color of the decrement or increment arrow(or triangle) of this scroll bar control to the specified value(SFXRGBColor).

Default: SFXRGBColor(0x00, 0x00, 0x00, 0x00)[black color]

Reference

SFYScrollBarControl::GetArrowColor | SFXRGBColor

Description

This function sets the bevel color to draw the outer frame of this scroll bar control to the specified value(SFXBevelColor).

Default: SFXBevelColor(SFXRGBColor(0xFF, 0xFF, 0xFF, 0x00), SFXRGBColor(0xCC, 0xCC, 0xCC, 0x00), SFXRGBColor(0x88, 0x88, 0x88, 0x00))

Reference

SFYScrollBarControl::GetBevelColor | SFXBevelColor | SFXRGBColor

Description

This function sets the region for the "decrement arrow" label of this scroll bar control to the specified value.

Reference

SFYScrollBarControl::GetDecrementArrowRectangle

Description

This function sets the region for the "increment arrow" label of this scroll bar control to the specified value.

Reference

SFYScrollBarControl::GetIncrementArrowRectangle

Description

This function sets the orientation of this scroll bar control to the specified value.

The horizontal(SFYScrollBarControl::HORIZONTAL) or vertical(SFYScrollBarControl::VERTICAL) orientation can be specified in the argument.

Default: SFYScrollBarControl::VERTICAL

Reference

SFYScrollBarControl::GetOrientation | SFYScrollBarControl::OrientationEnum

Description

This function sets the page size of this scroll bar control to the specified value.

The page size corresponds to the thumb length.

The value less than {(maximum value) - (minimum value) } needs to be specified in the argument.

Reference

SFYScrollBarControl::GetPageValue

Description

This function sets the scroll step of this scroll bar control to the specified value.

Reference

SFYScrollBarControl::GetScrollStepValue

Description

This function sets the color of the track of this scroll bar control to the specified value(SFXRGBColor), in which color the rectangle for the track will be filled.

Default: SFXRGBColor(0xF0, 0xF0, 0xF0, 0x00)[light gray color]

Reference

SFYScrollBarControl::GetTrackColor | SFXRGBColor

Description

This function sets the region for the track of this scroll bar control to the specified value.

Reference

SFYScrollBarControl::GetTrackRectangle

Reference

SFYResponder::GetType | SFYResponder::SetType