Package com.iizix.prop.ui

Class UILabel

    • Field Detail

      • PN_LABEL_FOR

        public static final java.lang.String PN_LABEL_FOR
        Property name "labelFor".
        See Also:
        Constant Field Values

      • PN_LABEL_TYPE

        public static final java.lang.String PN_LABEL_TYPE
        Property name for label type "typ".
        See Also:
        Constant Field Values

      • PN_TEXT_ALIGN_X

        public static final java.lang.String PN_TEXT_ALIGN_X
        Property name for horizontal text alignment: "ax".
        See Also:
        Constant Field Values

      • PN_TEXT_ALIGN_Y

        public static final java.lang.String PN_TEXT_ALIGN_Y
        Property name for vertical text alignment: "ay".
        See Also:
        Constant Field Values

    • Constructor Detail

      • UILabel

        public UILabel()
        Creates the component without a name. The name must be set in all cases using the setPropertyAtom call.

      • UILabel

        public UILabel​(Atom propertyAtom)
        Creates the component with the specified name. All system-reserved names for components begins with "$".
        Parameters:
        propertyAtom - the name of the component, unique within it's parent.

      • UILabel

        public UILabel​(Atom propertyAtom,
               GProp<?>[] newValue)
        throws PropException
        Creates the component with the specified name, initialized to contain the GProp items. All system-reserved names for components begins with "$".
        Parameters:
        propertyAtom - The name of the component, unique within it's parent.
        newValue - The array of all properties the component should have.
        Throws:
        PropException - when at least one of the properties to initialize the component with is invalid.

    • Method Detail

      • clone

        public UILabel clone()
        Clones the label.
        Overrides:
        clone in class UIComp
        Returns:
        A label clone.

      • getDeviceType

        public final int getDeviceType()
        Gets the device type: -1=mobile, 0=both, 1=desktop.
        Specified by:
        getDeviceType in interface IUIComp

      • isMobileContextMenuSupported

        public boolean isMobileContextMenuSupported()
        Returns if the component can show the context menu in mobile mode.
        Specified by:
        isMobileContextMenuSupported in interface IUIContextMenuOwner
        Returns:
        Label component supports context menus for mobile.

      • setLabelReference

        public boolean setLabelReference​(IUILabelForTarget comp)
        Sets the component as label reference, i.e. when clicked upon, either for is set to the component, or if it is e.g. a checkbox, radio button or switch, that component will change its state.
        Parameters:
        comp - The UI component, null to clear it.
        Returns:
        true for change, false for no change.

      • setLabelType

        public boolean setLabelType​(int type)
        Sets the label type, i.e. how the line should be processed: wrap over multiple lines, single line (default), single line and ellipsis when it overflows horizontally, or fill label horizontally and vertically.
        Parameters:
        type - -1=single line (default), 0=multiple, 1=single (default), 2=ellipsis, 3=fill.
        Returns:
        true for change, false for no change.
        Throws:
        java.lang.IllegalArgumentException - if different.

      • canRequestFocus

        public java.lang.String canRequestFocus()
        Returns if this component can receive focus. Focus capable components may override to return null for success, or other error message.
        Specified by:
        canRequestFocus in interface IPropCnr
        Overrides:
        canRequestFocus in class UIComp
        Returns:
        "Label not focusable" always.

      • couldRequestFocusIfVirtualized

        public java.lang.String couldRequestFocusIfVirtualized​(boolean ignoreStates)
        Returns if this component could receive focus if it would be virtualized. Focus capable components may override to return null for success, or other error message.
        Specified by:
        couldRequestFocusIfVirtualized in interface IPropCnr
        Parameters:
        ignoreStates - Flag indicating that states should be ignored, such as visible or enabled. If false, hidden or disabled components return an error message.
        Returns:
        "Label not focusable" always.

      • getApproximateSize

        public Size getApproximateSize()
        Returns the size of the component in pixels. The size is a calculation and does not exactly reflect the real size that may be different due to additional styles not taken into account by this method. The size is calculated from the font of the component and default or defined values (such as character length or number of lines for text area).
        Specified by:
        getApproximateSize in class UIComp
        Returns:
        The size of the component: 16x16 TODO!.