Example 869. Declaration

SFMTYPEDEFRESPONDER(USRLabelControl)
class USRLabelControl: public SFYLabelControl {
    SFMSEALRESPONDER(USRLabelControl)
    SFMRESPONDERINSTANTIATEFOUR(USRLabelControl, SFYLabelControl, SFYControl, SFYWidget, SFYResponder)
public:

    // define responder type
    // small alphabet and symbol must not be used since they are reserved for SophiaFramework UNIVERSE
    enum CodeEnum {
        CODE_TYPE = four_char_code('U', 'L', 'B', 'L')
    };
    SFMTYPEDEFTYPE(CodeEnum)

public:
    static USRLabelControlSmp NewInstance(SFCErrorPtr exception = null);
protected:
    explicit USRLabelControl(Void) static_throws;
    virtual ~USRLabelControl(Void);

    // virtual functions defined in the parent class and recommended to be implemented
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

Example 870. Implementation

USRLabelControl::USRLabelControl(Void) static_throws
{
    if (static_try()) {

        // set the responder type
 SetType(CODE_TYPE);

        // in general, set transparency attribute to "true" since label control does not have background
 SetPropertyTransparent(true);

        // here describe the initialization
    }
}

USRLabelControl::~USRLabelControl(Void)
{
    // here describe the finalization
}

USRLabelControlSmp USRLabelControl::NewInstance(SFCErrorPtr exception)
{
    return static_pointer_cast<USRLabelControl>(Factory(::new USRLabelControl, exception));
}

Void USRLabelControl::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    // in case of using function of SFYLabelControl class to draw focus border [i.e., SFYLabelControl::DrawFocus()],
    // deflate rectangle by size of focus border
    rectangle->Deflate(GetFocusMargin());

    // calculate the suitable focus border size
    // set the rectangle argument to the calculated suitable focus border size
    // for the rectangle argument, it is recommended to set only its size and not to change its origin in this function

    // in case of using function of SFYLabelControl class to draw focus border [i.e., SFYLabelControl::DrawFocus()],
    // inflate rectangle by size of focus border
    rectangle->Inflate(GetFocusMargin());

    return;
}

Void USRLabelControl::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    // in case of using function of SFYLabelControl class to draw focus border [i.e., SFYLabelControl::DrawFocus()],
    // deflate rectangle by size of focus border
    rectangle->Deflate(GetFocusMargin());

    // calculate the suitable focus border size within rectangular region given by the rectangle argument
    // set the rectangle argument to the calculated suitable focus border size
    // for the rectangle argument, it is recommended to set only its size and not to change its origin in this function

    // in case of using function of SFYLabelControl class to draw focus border [i.e., SFYLabelControl::DrawFocus()],
    // inflate rectangle by size of focus border
    rectangle->Inflate(GetFocusMargin());

    return;
}

Void USRLabelControl::HandleBoundVirtual(Void)
{
    // here describe the size recalculation if necessary when the virtual region is changed

    return;
}

Void USRLabelControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // in case of using function of SFYLabelControl class to draw focus border [i.e., SFYLabelControl::DrawFocus()],
    // draw focus border as below
    DrawFocus(graphics, GetLocalBound());

    // draw inside focus border

    return;
}