Inheritance diagram

Collaboration diagram

Description

How to use

Radio button control(SFZRadiobuttonControl) will receive the result event [SFXEvent(SFEVT_RESPONDER_RESULT, SFP16_RESULT_OK, SFYControl::GetCurrentValue())] if the operation key set with the SFYButtonControl::SetOperateKey function is released after pressed.

	Note
	This result event will occur in the SFYRadiobuttonControl::HandleOperateKeyRelease function.

If there are more characters than can be displayed in the text region of a radio button control, this control will start to scroll automatically when it is in the focused state.

By grouping more than one radio button control, exclusive choice is automatically implemented.

Figure 367. Execution Result

Structure of the radio button control

In the default implementation, the radio button control is drawn as below depending on the state.

Figure 368. Expanded figure of the radio button[in the "active" or "enable" state]

Figure 369. Expanded figure of the radio button[In the focused state, when not pressed]

Figure 370. Expanded figure of the radio button control[In the "active" or "enable" state, when not pressed]

The radio button is drawn in the left side, and the text is drawn in the right side.

For more details: SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow

Figure 371. Expanded figure of the radio button control[in the "inactive" state]

The text is drawn in the color set with the SFZRadiobuttonControl::SetTextColor which is adjusted to the "inactive" state.

For more details: SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow

Figure 372. Expanded figure of the radio button control[In the focused state, when not pressed]

For more details: SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow

Figure 373. Expanded figure of the radio button control[In the focused state, when pressed]

For more details: SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow

	Default value of the transparency attribute
	Since the transparency attribute of this class is set to "true" by default, the background will not be filled in the color set with the SFYWidget::SetBackgroundColor function unless this transparency attribute is set to "false".

Reference

Radio Button Control [SFZRadiobuttonControl] | State | SFYControl | SFYButtonControl | SFYCheckboxControl | SFYRadiobuttonControl | SFYSingleTextWidget

Member

Description

This constructor performs the initializations as follows:

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

Reference

SFYResponder::SetType | SFZRadiobuttonControl::CodeEnum | SFYResponder::SetParent | SFYResponder::SetState | SFZRadiobuttonControl::SetText | SFZRadiobuttonControl::SetFont | SFZRadiobuttonControl::SetTextColor | SFZRadiobuttonControl::SetHorizontalAlign | SFZRadiobuttonControl::SetVerticalAlign | SFZRadiobuttonControl::SetScrollDirection | SFZRadiobuttonControl::SetScrollInterval | SFZRadiobuttonControl::SetScrollStep | SFZRadiobuttonControl::SetWaitInterval | SFZRadiobuttonControl::HorizontalEnum | SFZRadiobuttonControl::VerticalEnum | SFZRadiobuttonControl::DirectionEnum | SFZRadiobuttonControl::DefaultEnum | SFYSingleTextWidget::NewInstance | SFYSingleTextWidget | SFXRGBColor | Type | State | Event | State Event[SFEVT_RESPONDER_STATE]

Description

This destructor does nothing.

Description

This function gets the button region of this radio button control.

	Note
	The radio button control consists of the button part and the text part.

Description

This function gets the font.

Reference

SFZRadiobuttonControl::SetFont

Description

This function gets the horizontal alignment.

Reference

SFZRadiobuttonControl::SetHorizontalAlign | SFZRadiobuttonControl::HorizontalEnum

Description

This function gets the scroll direction.

Reference

SFZRadiobuttonControl::SetScrollDirection

Description

This function gets the scroll-interval. [milliseconds]

Reference

SFZRadiobuttonControl::SetScrollInterval

Description

This function gets the scroll-step. [pixels]

Reference

SFZRadiobuttonControl::SetScrollStep

Description

This function gets the text.

Reference

SFZRadiobuttonControl::SetText

Description

This function gets the color of text.

Reference

SFZRadiobuttonControl::SetTextColor | SFXRGBColor

Description

This function gets the vertical alignment.

Reference

SFZRadiobuttonControl::SetVerticalAlign | SFZRadiobuttonControl::VerticalEnum

Description

This function gets the waiting time to start to scroll. [milliseconds]

Reference

SFZRadiobuttonControl::SetWaitInterval

Description

This function gets the instance of the SFYSingleTextWidget class, which is contained as a child responder internally for drawing a single text.

The drawing of the single text is delegated to the SFYSingleTextWidget class.

Reference

SFYSingleTextWidget

Description

This function will be called when the region event [SFXEvent(SFEVT_RESPONDER_BOUND, SFP16_BOUND_OPTIMIZE, rectangle)] is received.

This function calculates the suitable rectangle size of this responder within the specified hint rectangle[i.e., rectangle element (P32 parameter) of the region event].

The suitable rectangle size is stored into the size element of the rectangle argument as a result of calculation. It is recommended not to change the origin of the rectangle argument in this function.

	Region event[(SFEVT_RESPONDER_BOUND, SFP16_BOUND_OPTIMIZE) event]
	If the rectangle argument of the hint region is specified, the SFYResponder::GetSuitableBound function will send the region event [SFXEvent(SFEVT_RESPONDER_BOUND, SFP16_BOUND_OPTIMIZE, rectangle)] to this responder. Then, the SFYWidget::HandleBoundOptimize virtual function will be called. The rectangle element (P32 parameter) of the region event is set to the hint region as an initial value.

Reference: SFYSingleTextWidget::HandleBoundOptimize

Internal Implementation

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

SFYSingleTextWidgetSmp          _widget;
SFXRectangle                    _bound;

/*protected virtual */Void SFZRadiobuttonControl::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    SFXSize                                     size;
    SInt16                                      width;

    width = _bound.GetWidth() + _widget->GetFontSize().GetWidth() / 2;
    rectangle->Deflate(width, 0, 0, 0);
    size.Set(_widget->GetSuitableBound(*rectangle).GetSize());
    rectangle->Inflate(width, 0, 0, 0);
    if (!size.IsEmpty()) {
        size.AddWidth(width);
        if (size.GetHeight() < _bound.GetHeight()) {
            size.SetHeight(_bound.GetHeight());
        }
    }
    else {
        size.Set(_bound.GetSize());
    }
    if (rectangle->GetWidth() > size.GetWidth()) {
        rectangle->SetWidth(size.GetWidth());
    }
    if (rectangle->GetHeight() > size.GetHeight()) {
        rectangle->SetHeight(size.GetHeight());
    }
    return;
}// SFZRadiobuttonControl::HandleBoundOptimize //

Reference

SFYResponder::GetSuitableBound | SFZRadiobuttonControl::SetText | SFZRadiobuttonControl::SetFont | SFYSingleTextWidget::HandleBoundOptimize | SFXEvent | Region Event[SFEVT_RESPONDER_BOUND] | Handler for the Region Event[XANDLER_DECLARE_VOIDBOUND]

Description

This function will be called when the region event [SFXEvent(SFEVT_RESPONDER_BOUND, SFP16_BOUND_REQUEST, rectangle)] is received.

This function calculates the suitable rectangle size of this responder.

The suitable rectangle size is stored into the size element of the rectangle argument as a result of calculation. It is recommended not to change the origin element of the rectangle argument within this function.

Region event[(SFEVT_RESPONDER_BOUND, SFP16_BOUND_REQUEST) event]

If the rectangle argument of the hint region is not specified, the SFYResponder::GetSuitableBound function will send the region event [SFXEvent(SFEVT_RESPONDER_BOUND, SFP16_BOUND_REQUEST, rectangle)] to this responder. Then, the SFYWidget::HandleBoundRequest virtual function will be called. The rectangle element (P32 parameter) of the region event is set to the real region as an initial value. Tip Default value of the real region: SFXRectangle(0, 0, 0, 0)

Internal Implementation

Internal implementation of the SFZRadiobuttonControl::HandleBoundRequest function is as follows:

SFYSingleTextWidgetSmp          _widget;
SFXRectangle                    _bound;

/*protected virtual */Void SFZRadiobuttonControl::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    SFXSize                                     size;

    size.Set(_widget->GetSuitableBound().GetSize());
    if (!size.IsEmpty()) {
        size.AddWidth(_bound.GetWidth() + _widget->GetFontSize().GetWidth() / 2);
        if (size.GetHeight() < _bound.GetHeight()) {
            size.SetHeight(_bound.GetHeight());
        }
    }
    else {
        size.Set(_bound.GetSize());
    }
    rectangle->SetSize(size);
    return;
}// SFZRadiobuttonControl::HandleBoundRequest //

Reference

SFYResponder::GetSuitableBound | SFXEvent | Real Region Region Event[SFEVT_RESPONDER_BOUND] | Handler for the Region Event[XANDLER_DECLARE_VOIDBOUND]

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 equalize the real region with the new local region and relocate this responder to fit into the new virtual region.

	About the virtual region
	In this class, it is recommended to equalize the virtual region with the real region for the intuitive text alignment or scroll. For instance, though all the text is not displayed, the text will not start to scroll even if the SFYSingleTextWidget::StartScroll function is called when the following relation stands up. [Width of virtual region] [Width of text] [Width of real 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 SFZRadiobuttonControl::HandleBoundVirtual function is as follows:

SFYSingleTextWidgetSmp          _widget;
SFXRectangle                    _bound;

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

/*private */Void SFZRadiobuttonControl::Relocate(Void)
{
    static SFXSize::AtomRecConst                style[] = {
        {14, 14},
        {28, 28}
    };
    SFXRectangle                                lx;
    SFXRectangle                                widget;
    SFXSize                                     font;
    SInt32                                      r0;
    SInt16                                      size;
    SInt16                                      offset;

    font.Set(_widget->GetFontSize());
    for (r0 = 0; r0 < static_cast<SInt32>(lengthof(style)) - 1; ++r0) {
        if (font.GetHeight() < style[r0 + 1].height) {
            break;
        }
    }
    lx.Set(GetLocalBound());
    _bound.Set(lx.GetOrigin(), style[r0]);
    widget.Set(lx.GetOrigin(), _widget->GetSuitableBound().GetSize());
    widget.SnapLeft(_bound.GetRight() + font.GetWidth() / 2);
    if (widget.GetRight() > lx.GetRight()) {
        widget.SetRight(lx.GetRight());
    }
    size = _bound.GetWidth();
    if (!widget.IsEmpty()) {
        size += font.GetWidth() / 2 + widget.GetWidth();
    }
    offset = 0;
    switch (_widget->GetHorizontalAlign()) {
        case SFYSingleTextWidget::HORIZONTAL_LEFT:
            offset += 0;
            break;
        case SFYSingleTextWidget::HORIZONTAL_RIGHT:
            offset += lx.GetWidth() - size;
            break;
        case SFYSingleTextWidget::HORIZONTAL_CENTER:
        default:
            offset += (lx.GetWidth() - size) / 2;
            break;
    }
    _bound.AddX(offset);
    widget.AddX(offset);
    size = ((_bound.GetHeight() > widget.GetHeight()) ? (_bound.GetHeight()) : (widget.GetHeight()));
    offset = 0;
    switch (_widget->GetVerticalAlign()) {
        case SFYSingleTextWidget::VERTICAL_TOP:
            offset += 0;
            break;
        case SFYSingleTextWidget::VERTICAL_BOTTOM:
            offset += lx.GetHeight() - size;
            break;
        case SFYSingleTextWidget::VERTICAL_MIDDLE:
        default:
            offset += (lx.GetHeight() - size) / 2;
            break;
    }
    _bound.AddY(offset + (size - _bound.GetHeight()) / 2);
    widget.AddY(offset + (size - widget.GetHeight()) / 2);
    _widget->SetRealBound(widget);
    return;
}// SFZRadiobuttonControl::Relocate //

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 SFEVT_KEY event(key event[SFEVT_KEY]) of the operaion key set with the SFYButtonControl::SetOperateKey function is received.

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

In the default implementation, the postion of the text scrolling is initialized.

Internal Implementation

Internal implementation of the SFZRadiobuttonControl::HandleOperateKey function is as follows:

SFYSingleTextWidgetSmp          _widget;

/*protected virtual */Void SFZRadiobuttonControl::HandleOperateKey(Void)
{
    _widget->StopScroll();
    _widget->StartScroll();
    return;
}// SFZRadiobuttonControl::HandleOperateKey //

Reference

SFYButtonControl::SetOperateKey | Key Event[SFEVT_KEY]

Description

This function will be called when the (SFEVT_RESPONDER_RENDER, SFP16_RENDER_REQUEST) event is received.

In case you want to perform your own drawing of this responder, override this function.

The default implementation is to draw this responder.

The method to darw a responder

In addition to overriding this virtual function, it is possible to define and implement the handler for drawing event(drawing handler)[XANDLER_DECLARE_VOIDRENDER], and register it into the responder. Then, the overridden virtual function will be called first, and next the drawing handlers registered into the responder will be booted up in the registered order. In almost all cases, the method to override this function is used to draw the responder since there is no need to declare and register the drawing handler.

Procedure of drawing a responder

The drawing handler will be booted up when the drawing event(SFEVT_RESPONDER_RENDER) occurs. And then the drawing handler draw the responder actually. The drawing event will be sent to only the responders including the region to be redrawn out of the redraw regions registered into the renderer using the SFYResponder::InvokeBackward function after the SFYResponder::Render function boots up the renderer. Here, the SFYResponder::Render function will be called at the following situations: At the end of the event loop At the applet start / resume or the end of a highest priority event handler In the callback, which is outside the event loop. If calling the SFYResponder::Render function with specifying "true" as an argument, the drawing event will be sent to all the responders to be actually displayed on the screen which are located below the responder in the responder tree, regardless of the registration of redraw region.

Internal Implementation

Internal implementation of the SFZRadiobuttonControl::HandleRenderRequest function is as follows:

SFXRectangle                    _bound;

/*protected virtual */Void SFZRadiobuttonControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    SFXGrid                                     grid;

    if (_bound.GetHeight() >= 28) {
        grid.Set(DrawShadow28(graphics, _bound.GetOrigin()));
        DrawButton27(graphics, grid);
        grid.Add(8, 8);
        DrawCheckmark11(graphics, grid);
    }
    else if (_bound.GetHeight() >= 14) {
        grid.Set(DrawShadow14(graphics, _bound.GetOrigin()));
        DrawButton13(graphics, grid);
        grid.Add(4, 4);
        DrawCheckmark05(graphics, grid);
    }
    return;
}// SFZRadiobuttonControl::HandleRenderRequest //

Reference

SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow | SFYCheckboxControl::SetCheckmarkColor | SFYButtonControl::SetButtonColor | SFYButtonControl::SetFocusColor | SFYButtonControl::SetShadowColor | SFYButtonControl::SetOperateKey | SFYRadiobuttonControl::DrawButton13 | SFYRadiobuttonControl::DrawButton27 | SFYRadiobuttonControl::DrawShadow14 | SFYRadiobuttonControl::DrawShadow28 | SFYRadiobuttonControl::DrawCheckmark05 | SFYRadiobuttonControl::DrawCheckmark11 | SFZRadiobuttonControl::SetText | SFZRadiobuttonControl::SetHorizontalAlign | SFZRadiobuttonControl::SetVerticalAlign | SFZRadiobuttonControl::SetFont | SFZRadiobuttonControl::SetTextColor | SFYSingleTextWidget | SFYSingleTextWidget::HandleRenderRequest | SFYResponder::Invalidate | SFYResponder::Render | SFYResponder::InvokeBackward | Drawing Event[SFEVT_RESPONDER_RENDER] | Handler for the Drawing Event[XANDLER_DECLARE_VOIDRENDER] | Rendering | State

Argument

Return value

Description

This function creates a new instance of this responder class.

If succeeds, a not null pointer will be returned, and the "exception" argument is SFERR_NO_ERROR. If fails such as insufficient memory, a null pointer will be returned, and the "exception" argument holds the error value.

Example

The code to create a new instance of this responder class is as follows:

SFZRadiobuttonControlSmp _radiobutton;
SFCError error;

if ((_radiobutton = SFZRadiobuttonControl::NewInstance(&error)) != null) {

    ...
}

Description

Default: AEE_FONT_NORMAL

Reference

SFZRadiobuttonControl::GetFont

Description

This function sets the horizontal alignment to the specified value.

Default: SFYSingleTextWidget::DEFAULT_HORIZONTAL

For the value of SFYSingleTextWidget::DEFAULT_HORIZONTAL, refer to SFYSingleTextWidget::HorizontalEnum.

Reference

SFZRadiobuttonControl::GetHorizontalAlign | SFZRadiobuttonControl::HorizontalEnum | SFYSingleTextWidget::HorizontalEnum

Description

This function sets the scroll direction to the specified value.

Default: SFZRadiobuttonControl::DEFAULT_DIRECTION

For the value of SFZRadiobuttonControl::DEFAULT_DIRECTION, refer to SFZRadiobuttonControl::DirectionEnum.

Reference

SFZRadiobuttonControl::GetScrollDirection | SFZRadiobuttonControl::DirectionEnum

Description

Default: SFZRadiobuttonControl::DEFAULT_SCROLL [milliseconds]

For the value of SFZRadiobuttonControl::DEFAULT_SCROLL, refer to SFZRadiobuttonControl::DefaultEnum.

Reference

SFZRadiobuttonControl::GetScrollInterval | SFZRadiobuttonControl::DefaultEnum

Description

This function sets the number of pixels of each scroll. If "-1"(this is default value) is set, the scroll-step will be set to the width of the " " character of the currently used font.

Default: SFZRadiobuttonControl::DEFAULT_STEP [pixels]

For the value of SFZRadiobuttonControl::DEFAULT_STEP, refer to SFZRadiobuttonControl::DefaultEnum.

Reference

SFZRadiobuttonControl::GetScrollStep | SFZRadiobuttonControl::DefaultEnum

Return value

Description

This function sets the text to be displayed to the specified value.

The value of string is set directly in the argument, or read from the resource file.

Reference

SFZRadiobuttonControl::GetText | SFZRadiobuttonControl::SetHorizontalAlign | SFZRadiobuttonControl::SetVerticalAlign | SFZRadiobuttonControl::SetTextColor | SFZRadiobuttonControl::SetFont

Description

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

In the "inactive" state, the text will be drawn in the color of which each RGB value is subtracted 0x44 from the color set with this function if the brightness of this color is greater than 0x7F. Otherwise it will be drawn in the color of which each RGB value is added 0x44 on the color set with this function.

The brightness of color can be obtained by calling the SFXRGBColor::GetBrightness function.

Reference

SFZRadiobuttonControl::GetTextColor | SFXRGBColor::GetBrightness | SFXRGBColor | State

Description

This function sets the vertical alignment to the specified value.

Default: SFYSingleTextWidget::DEFAULT_VERTICAL

For the value of SFYSingleTextWidget::DEFAULT_VERTICAL, refer to SFYSingleTextWidget::VerticalEnum.

Reference

SFZRadiobuttonControl::GetVerticalAlign | SFZRadiobuttonControl::VerticalEnum | SFYSingleTextWidget::VerticalEnum

Description

Default: SFZRadiobuttonControl::DEFAULT_SCROLL [milliseconds]

For the value of SFZRadiobuttonControl::DEFAULT_SCROLL, refer to SFZRadiobuttonControl::DefaultEnum.

Reference

SFZRadiobuttonControl::GetWaitInterval | SFZRadiobuttonControl::DefaultEnum

Description

If the width of the text is greater than that of the virtual region, the text will start to scroll.

Otherwise, the text will not scroll.

Though the SFEVT_APP_SUSPEND event and the SFEVT_APP_RESUME event will be automatically handled, the behaviour of this function is not defined when called between the SFEVT_APP_SUSPEND event and the SFEVT_APP_RESUME event.

Reference

SFZRadiobuttonControl::StopScroll | Virtual Region

Reference

SFZRadiobuttonControl::StartScroll

Reference

SFYResponder::GetType | SFYResponder::SetType

Reference

SFYSingleTextWidget::HorizontalEnum

Reference

SFYSingleTextWidget::VerticalEnum