crossmobile.ios.uikit

Class UILabel

java.lang.Object

crossmobile.ios.foundation.NSObject

crossmobile.ios.uikit.UIResponder

crossmobile.ios.uikit.UIView

crossmobile.ios.uikit.UILabel

All Implemented Interfaces:

UIAccessibilityIdentification, UIAppearance, UIAppearanceContainer

public class UILabel
extends UIView

UILabel class defines a specialized view that is used to display read-only text.

Field Summary

Fields inherited from class crossmobile.ios.uikit.UIView

NoIntrinsicMetric

Constructor Summary

Constructors

Constructor and Description
UILabel() Constructs a default UILabel object located at (0,0) with 0 weight and 0 height.
UILabel(CGRect frame) Constructs a UILabel object using the specified rectangle.

Method Summary

Modifier and Type	Method and Description
boolean	adjustsFontSizeToFitWidth() Returns a Boolean that shows whether the font size of the title is adjusted to label's size.
int	baselineAdjustment() Returns a number that shows how baselines are adjusted when text size changes to fit the label.
void	drawRect(CGRect rect) This method is implicitly called when a view is first displayed or when an event occurs that invalidates a visible part of the view and the view needs to be redrawn.
void	drawTextInRect(CGRect rect) Actual procedure of drawing text in this label
UIFont	font() Returns the font of the label's text.
UIColor	highlightedTextColor() Returns the highlight color of label's text.
boolean	isHighlighted() Returns a Boolean that shows whether this label is highlighted.
int	lineBreakMode() Returns the technique that is used to wrap and shorten the text of the label.
double	minimumScaleFactor() Returns the minimum scale factor of label.
int	numberOfLines() Returns the maximum number of lines for rendering the text.
double	preferredMaxLayoutWidth() Returns the maximum width of a label with multiple lines.Expressed in points.
void	setAdjustsFontSizeToFitWidth(boolean adjustsFontSizeToFitWidth) Sets a Boolean that defines whether the font size of the title should adjust to label's size.
void	setBaselineAdjustment(int baselineAdjustment) Sets a value that defines how baselines are adjusted when text size changes
void	setFont(UIFont font) Sets the font of the label's text.
void	setFrame(CGRect frame) Sets view's dimensions and position according to the structure specified as frame parameter.
void	setHighlighted(boolean highlighted) Sets a Boolean that shows whether this label should be highlighted.
void	setHighlightedTextColor(UIColor highlightedTextColor) Sets the highlight color of label's text.
void	setLineBreakMode(int NSLineBreakMode) Sets technique to use in order to wrap and shorten the text of the label.
void	setMinimumScaleFactor(double minimumScaleFactor) Sets the minimum scale factor of label.
void	setNumberOfLines(int numberOfLines) Sets the maximum number of lines for rendering the text.
void	setPreferredMaxLayoutWidth(double preferredMaxLayoutWidth) Sets the maximum width of a label with multiple lines.
void	setShadowColor(UIColor shadowColor) Sets the shadow color of the text into the label.
void	setShadowOffset(CGSize shadowOffset) Sets the shadow offset for the label's text expressed in points.
void	setText(String text) Sets the text to be displayed on the label.
void	setTextAlignment(int NSTextAlignment) Sets the alignment technique for the text of the label.
void	setTextColor(UIColor color) Sets the color of the label's text.
UIColor	shadowColor() Returns the shadow color of the text into the label.
CGSize	shadowOffset() Returns the shadow offset of the label's text expressed in points.
String	text() Returns the text that is displayed on the label.
int	textAlignment() Returns the alignment technique for the text of the label.
UIColor	textColor() Returns the color of the label's text.
CGRect	textRectForBounds(CGRect bounds, int numberOfLines) Calculate the required dimension for this UILabel, that the desired text could be drawn in

Methods inherited from class crossmobile.ios.uikit.UIView

accessibilityIdentifier, addConstraint, addConstraints, addGestureRecognizer, addLayoutGuide, addSubview, alpha, animateWithDuration, animateWithDuration, animateWithDuration, areAnimationsEnabled, autoresizesSubviews, autoresizingMask, backgroundColor, bottomAnchor, bounds, bringSubviewToFront, center, centerXAnchor, centerYAnchor, clipsToBounds, constraints, contentCompressionResistancePriorityForAxis, contentHuggingPriorityForAxis, contentMode, convertPointFromView, convertPointToView, convertRectFromView, convertRectToView, didAddSubview, didMoveToSuperview, didMoveToWindow, frame, gestureRecognizers, heightAnchor, hitTest, insertSubview, insetsLayoutMarginsFromSafeArea, intrinsicContentSize, invalidateIntrinsicContentSize, isHidden, isMultipleTouchEnabled, isOpaque, isUserInteractionEnabled, layer, layoutIfNeeded, layoutMargins, layoutMarginsDidChange, layoutMarginsGuide, layoutSubviews, leadingAnchor, leftAnchor, maskView, needsUpdateConstraints, nextResponder, overrideUserInterfaceStyle, pointInside, preservesSuperviewLayoutMargins, removeConstraint, removeConstraints, removeFromSuperview, removeGestureRecognizer, removeLayoutGuide, requiresConstraintBasedLayout, restorationIdentifier, rightAnchor, safeAreaInsets, safeAreaLayoutGuide, sendSubviewToBack, setAccessibilityIdentifier, setAlpha, setAnimationBeginsFromCurrentState, setAnimationCurve, setAnimationDelay, setAnimationDuration, setAnimationRepeatAutoreverses, setAnimationRepeatCount, setAnimationsEnabled, setAnimationStartDate, setAutoresizesSubviews, setAutoresizingMask, setBackgroundColor, setBounds, setCenter, setClearsContextBeforeDrawing, setClipsToBounds, setContentCompressionResistancePriority, setContentHuggingPriority, setContentMode, setGestureRecognizers, setHidden, setInsetsLayoutMarginsFromSafeArea, setLayoutMargins, setMaskView, setMultipleTouchEnabled, setNeedsDisplay, setNeedsLayout, setNeedsUpdateConstraints, setOpaque, setOverrideUserInterfaceStyle, setPreservesSuperviewLayoutMargins, setRestorationIdentifier, setTag, setTintAdjustmentMode, setTintColor, setTransform, setTranslatesAutoresizingMaskIntoConstraints, setUserInteractionEnabled, sizeThatFits, sizeToFit, subviews, superview, tag, tintAdjustmentMode, tintColor, tintColorDidChange, topAnchor, toString, trailingAnchor, transform, transitionWithView, translatesAutoresizingMaskIntoConstraints, updateConstraints, updateConstraintsIfNeeded, userInterfaceLayoutDirection, viewForFirstBaselineLayout, viewForLastBaselineLayout, widthAnchor, willMoveToSuperview, willMoveToWindow, willRemoveSubview, window

Methods inherited from class crossmobile.ios.uikit.UIResponder

becomeFirstResponder, isFirstResponder, resignFirstResponder, touchesBegan, touchesCancelled, touchesEnded, touchesMoved

Methods inherited from class crossmobile.ios.foundation.NSObject

addObserver, observeValueForKeyPath, performSelector, performSelectorOnMainThread, release, removeObserver, removeObserver, retain, setValueForKey, setValueForUndefinedKey, valueForKey, valueForUndefinedKey

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

UILabel

public UILabel()

Constructs a default UILabel object located at (0,0) with 0 weight and 0 height.

UILabel

public UILabel(CGRect frame)

Constructs a UILabel object using the specified rectangle.

Parameters:

frame - The rectangle in which to draw the text

Method Detail

setFrame

public void setFrame(CGRect frame)

Description copied from class: UIView

Sets view's dimensions and position according to the structure specified as frame parameter.

Overrides:

setFrame in class UIView

Parameters:

frame - The structure that defines view's dimensions and position in the coordinate system of its superview.

setText

public void setText(String text)

Sets the text to be displayed on the label.

Parameters:

text - The text to be displayed on the label.

text

public String text()

Returns the text that is displayed on the label.

Returns:

The text displayed on the label.

setFont

public void setFont(UIFont font)

Sets the font of the label's text.

Parameters:

font - The font of the label's text.

font

public UIFont font()

Returns the font of the label's text.

Returns:

The font of the label's text.

setTextColor

public void setTextColor(UIColor color)

Sets the color of the label's text.

Parameters:

color - The color of the label's text.

textColor

public UIColor textColor()

Returns the color of the label's text.

Returns:

The color of the label's text.

setHighlighted

public void setHighlighted(boolean highlighted)

Sets a Boolean that shows whether this label should be highlighted.

Parameters:

highlighted - A Boolean that shows whether this label should be highlighted.

isHighlighted

public boolean isHighlighted()

Returns a Boolean that shows whether this label is highlighted.

Returns:

A Boolean that shows whether this label is highlighted.

setHighlightedTextColor

public void setHighlightedTextColor(UIColor highlightedTextColor)

Sets the highlight color of label's text.

Parameters:

highlightedTextColor - The highlight color of label's text.

highlightedTextColor

public UIColor highlightedTextColor()

Returns the highlight color of label's text.

Returns:

The highlight color of label's text.

setTextAlignment

public void setTextAlignment(int NSTextAlignment)

Sets the alignment technique for the text of the label.

Parameters:

NSTextAlignment - The alignment technique for the text of the label.

See Also:

NSTextAlignment

textAlignment

public int textAlignment()

Returns the alignment technique for the text of the label.

Returns:

The alignment technique for the text of the label.

setLineBreakMode

public void setLineBreakMode(int NSLineBreakMode)

Sets technique to use in order to wrap and shorten the text of the label.

Parameters:

NSLineBreakMode - The technique to use in order to wrap and shorten the text of the label.

lineBreakMode

public int lineBreakMode()

Returns the technique that is used to wrap and shorten the text of the label.

Returns:

The technique that is used to wrap and shorten the text of the label.

setNumberOfLines

public void setNumberOfLines(int numberOfLines)

Sets the maximum number of lines for rendering the text.

Parameters:

numberOfLines - The maximum number of lines for rendering the text.

numberOfLines

public int numberOfLines()

Returns the maximum number of lines for rendering the text.

Returns:

The maximum number of lines for rendering the text.

setShadowOffset

public void setShadowOffset(CGSize shadowOffset)

Sets the shadow offset for the label's text expressed in points.

Parameters:

shadowOffset - The shadow offset for the label's text expressed in points.

shadowOffset

public CGSize shadowOffset()

Returns the shadow offset of the label's text expressed in points.

Returns:

The shadow offset of the label's text expressed in points.

setShadowColor

public void setShadowColor(UIColor shadowColor)

Sets the shadow color of the text into the label.

Parameters:

shadowColor - The shadow color of the text into the label.

shadowColor

public UIColor shadowColor()

Returns the shadow color of the text into the label.

Returns:

The shadow color of the text into the label.

setMinimumScaleFactor

public void setMinimumScaleFactor(double minimumScaleFactor)

Sets the minimum scale factor of label.

Parameters:

minimumScaleFactor - The minimum scale factor of label.

minimumScaleFactor

public double minimumScaleFactor()

Returns the minimum scale factor of label.

Returns:

The minimum scale factor of label.

setPreferredMaxLayoutWidth

public void setPreferredMaxLayoutWidth(double preferredMaxLayoutWidth)

Sets the maximum width of a label with multiple lines. Expressed in points.

Parameters:

preferredMaxLayoutWidth - The maximum width of a label with multiple lines.

preferredMaxLayoutWidth

public double preferredMaxLayoutWidth()

Returns the maximum width of a label with multiple lines.Expressed in points.

Returns:

The maximum width of a label with multiple lines.

setBaselineAdjustment

public void setBaselineAdjustment(int baselineAdjustment)

Sets a value that defines how baselines are adjusted when text size changes

Parameters:

baselineAdjustment - A value that defines how baselines are adjusted when text size changes

baselineAdjustment

public int baselineAdjustment()

Returns a number that shows how baselines are adjusted when text size changes to fit the label.

Returns:

A number that shows how baselines are adjusted when text size changes to fit the label.

setAdjustsFontSizeToFitWidth

public void setAdjustsFontSizeToFitWidth(boolean adjustsFontSizeToFitWidth)

Sets a Boolean that defines whether the font size of the title should adjust to label's size.

Parameters:

adjustsFontSizeToFitWidth - A Boolean that defines whether the font size of the title should adjust to label's size.

adjustsFontSizeToFitWidth

public boolean adjustsFontSizeToFitWidth()

Returns a Boolean that shows whether the font size of the title is adjusted to label's size.

Returns:

A Boolean that shows whether the font size of the title is adjusted to label's size.

drawRect

public final void drawRect(CGRect rect)

Description copied from class: UIView

This method is implicitly called when a view is first displayed or when an event occurs that invalidates a visible part of the view and the view needs to be redrawn.

Overrides:

drawRect in class UIView

Parameters:

rect - The part of the view that need to be redrawn.

drawTextInRect

public void drawTextInRect(CGRect rect)

Actual procedure of drawing text in this label

Parameters:

rect - the rectangle of the drawing area

textRectForBounds

public CGRect textRectForBounds(CGRect bounds,
                                int numberOfLines)

Calculate the required dimension for this UILabel, that the desired text could be drawn in

Parameters:

bounds - the given size the area to draw into

numberOfLines - the number of lines allowed

Returns:

the rectangle which perfectly fits UILabel's text