Source code for enamlnative.widgets.text_clock

"""
Copyright (c) 2017-2022, CodeLV.

Distributed under the terms of the MIT License.

The full license is in the file LICENSE, distributed with this software.

Created on May 20, 2017

 
"""
from atom.api import ForwardTyped, Str, Typed, observe
from enaml.core.declarative import d_
from .text_view import ProxyTextView, TextView


class ProxyTextClock(ProxyTextView):
    """The abstract definition of a proxy TextClock object."""

    #: A reference to the Label declaration.
    declaration = ForwardTyped(lambda: TextClock)

    def set_format_12_hour(self, clock_format):
        raise NotImplementedError

    def set_format_24_hour(self, clock_format):
        raise NotImplementedError

    def set_time_zone(self, time_zone):
        raise NotImplementedError


[docs]class TextClock(TextView):
    """A simple control for displaying read-only text."""

    #: Specifies the formatting pattern used to display the date and/or time
    #: in 12-hour mode.
    format_12_hour = d_(Str())

    #: Specifies the formatting pattern used to display the date and/or time
    #: in 24-hour mode.
    format_24_hour = d_(Str())

    #: Sets the specified time zone to use in this clock.
    time_zone = d_(Str())

    #: A reference to the ProxyLabel object.
    proxy = Typed(ProxyTextClock)

    @observe("format_12_hour", "format_24_hour", "time_zone")
    def _update_proxy(self, change):

        super()._update_proxy(change)