com.telerik.widget.indicators

Class GaugeRadialNeedle

java.lang.Object

android.view.View

com.telerik.widget.indicators.GaugeIndicator

com.telerik.widget.indicators.GaugeRadialNeedle

All Implemented Interfaces:

Drawable.Callback, AccessibilityEventSource, KeyEvent.Callback

public class GaugeRadialNeedle
extends GaugeIndicator

A class that represent a needle indicator used in radial gauges.

Nested Class Summary

Nested classes/interfaces inherited from class com.telerik.widget.indicators.GaugeIndicator

GaugeIndicator.OnValueChangedListener

Nested classes/interfaces inherited from class android.view.View

View.AccessibilityDelegate, View.BaseSavedState, View.DragShadowBuilder, View.MeasureSpec, View.OnApplyWindowInsetsListener, View.OnAttachStateChangeListener, View.OnClickListener, View.OnContextClickListener, View.OnCreateContextMenuListener, View.OnDragListener, View.OnFocusChangeListener, View.OnGenericMotionListener, View.OnHoverListener, View.OnKeyListener, View.OnLayoutChangeListener, View.OnLongClickListener, View.OnScrollChangeListener, View.OnSystemUiVisibilityChangeListener, View.OnTouchListener

Field Summary

Fields inherited from class android.view.View

ACCESSIBILITY_LIVE_REGION_ASSERTIVE, ACCESSIBILITY_LIVE_REGION_NONE, ACCESSIBILITY_LIVE_REGION_POLITE, ALPHA, DRAWING_CACHE_QUALITY_AUTO, DRAWING_CACHE_QUALITY_HIGH, DRAWING_CACHE_QUALITY_LOW, FIND_VIEWS_WITH_CONTENT_DESCRIPTION, FIND_VIEWS_WITH_TEXT, FOCUS_BACKWARD, FOCUS_DOWN, FOCUS_FORWARD, FOCUS_LEFT, FOCUS_RIGHT, FOCUS_UP, FOCUSABLES_ALL, FOCUSABLES_TOUCH_MODE, GONE, HAPTIC_FEEDBACK_ENABLED, IMPORTANT_FOR_ACCESSIBILITY_AUTO, IMPORTANT_FOR_ACCESSIBILITY_NO, IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS, IMPORTANT_FOR_ACCESSIBILITY_YES, INVISIBLE, KEEP_SCREEN_ON, LAYER_TYPE_HARDWARE, LAYER_TYPE_NONE, LAYER_TYPE_SOFTWARE, LAYOUT_DIRECTION_INHERIT, LAYOUT_DIRECTION_LOCALE, LAYOUT_DIRECTION_LTR, LAYOUT_DIRECTION_RTL, MEASURED_HEIGHT_STATE_SHIFT, MEASURED_SIZE_MASK, MEASURED_STATE_MASK, MEASURED_STATE_TOO_SMALL, NO_ID, OVER_SCROLL_ALWAYS, OVER_SCROLL_IF_CONTENT_SCROLLS, OVER_SCROLL_NEVER, ROTATION, ROTATION_X, ROTATION_Y, SCALE_X, SCALE_Y, SCREEN_STATE_OFF, SCREEN_STATE_ON, SCROLL_AXIS_HORIZONTAL, SCROLL_AXIS_NONE, SCROLL_AXIS_VERTICAL, SCROLL_INDICATOR_BOTTOM, SCROLL_INDICATOR_END, SCROLL_INDICATOR_LEFT, SCROLL_INDICATOR_RIGHT, SCROLL_INDICATOR_START, SCROLL_INDICATOR_TOP, SCROLLBAR_POSITION_DEFAULT, SCROLLBAR_POSITION_LEFT, SCROLLBAR_POSITION_RIGHT, SCROLLBARS_INSIDE_INSET, SCROLLBARS_INSIDE_OVERLAY, SCROLLBARS_OUTSIDE_INSET, SCROLLBARS_OUTSIDE_OVERLAY, SOUND_EFFECTS_ENABLED, STATUS_BAR_HIDDEN, STATUS_BAR_VISIBLE, SYSTEM_UI_FLAG_FULLSCREEN, SYSTEM_UI_FLAG_HIDE_NAVIGATION, SYSTEM_UI_FLAG_IMMERSIVE, SYSTEM_UI_FLAG_IMMERSIVE_STICKY, SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN, SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION, SYSTEM_UI_FLAG_LAYOUT_STABLE, SYSTEM_UI_FLAG_LIGHT_STATUS_BAR, SYSTEM_UI_FLAG_LOW_PROFILE, SYSTEM_UI_FLAG_VISIBLE, SYSTEM_UI_LAYOUT_FLAGS, TEXT_ALIGNMENT_CENTER, TEXT_ALIGNMENT_GRAVITY, TEXT_ALIGNMENT_INHERIT, TEXT_ALIGNMENT_TEXT_END, TEXT_ALIGNMENT_TEXT_START, TEXT_ALIGNMENT_VIEW_END, TEXT_ALIGNMENT_VIEW_START, TEXT_DIRECTION_ANY_RTL, TEXT_DIRECTION_FIRST_STRONG, TEXT_DIRECTION_FIRST_STRONG_LTR, TEXT_DIRECTION_FIRST_STRONG_RTL, TEXT_DIRECTION_INHERIT, TEXT_DIRECTION_LOCALE, TEXT_DIRECTION_LTR, TEXT_DIRECTION_RTL, TRANSLATION_X, TRANSLATION_Y, TRANSLATION_Z, VISIBLE, X, Y, Z

Constructor Summary

Constructors

Constructor and Description
GaugeRadialNeedle(Context context) Creates an instance of the GaugeRadialNeedle class.
GaugeRadialNeedle(Context context, AttributeSet attrs) Creates an instance of the GaugeRadialNeedle class.
GaugeRadialNeedle(Context context, AttributeSet attrs, int defStyleAttr) Creates an instance of the GaugeRadialNeedle class.

Method Summary

Modifier and Type	Method and Description
float	getAnimationStartValue() Returns the start value used when animating the needle.
float	getBottomWidth() Returns the width of the bottom end of the needle.
int	getCircleFillColor() Returns an integer that represents the fill color of the circle.
Paint	getCircleFillPaint() Returns the Paint used to fill the needle's circle.
float	getCircleInnerRadius() Returns the circle's inned radius.
float	getCircleRadius() Returns the outer radius of the needle's circle.
int	getCircleStrokeColor() Returns an integer that represents the stroke color of the circle.
Paint	getCircleStrokePaint() Returns the Paint used to draw the circle's stroke.
float	getCircleStrokeWidth() Returns the needle's circle stroke width.
float	getLength() Returns the length of the needle.
float	getOffset() Returns the offset of the needle from the circle.
float	getTopWidth() Returns the width of the needle pointing end.
float	getValue() Returns tha value of the needle.
void	setAnimationStartValue(float animationStartValue) Sets the start value from which the animation will begin when the needle value is changed.
void	setBottomWidth(float bottomWidth) Sets the bottom width of the needle.
void	setCircleFillColor(int circleFillColor) Sets the color used to fill the circle of the needle.
void	setCircleFillPaint(Paint circleFillPaint) Sets the Paint used to fill the circle.
void	setCircleInnerRadius(float circleInnerRadius) Sets the inner radius of the circle.
void	setCircleRadius(float circleRadius) Sets the outer radius of the needle's circle.
void	setCircleStrokeColor(int circleStrokeColor) Sets the color used to stroke the circle of the needle.
void	setCircleStrokePaint(Paint circleStrokePaint) Sets the Paint used to draw circle's stroke.
void	setCircleStrokeWidth(float circleStrokeWidth) Sets the circle's stroke width.
void	setLength(float length) Sets the length of the needle.
void	setOffset(float offset) Sets the offset of the needle from the circle.
void	setTopWidth(float topWidth) Sets the width of the needles pointing end.
void	setValue(float value) Sets the value of the needle.
void	startAnimation() Starts animating the indicator if the animations are on.

Methods inherited from class com.telerik.widget.indicators.GaugeIndicator

getAnimationDuration, getFillColor, getFillPaint, getInterpolator, getOnValueChangedListener, getScale, getStrokeColor, getStrokePaint, getStrokeWidth, isAnimated, requestRender, setAnimated, setAnimationDuration, setFillColor, setFillPaint, setInterpolator, setOnValueChangedListener, setScale, setStrokeColor, setStrokePaint, setStrokeWidth

Methods inherited from class android.view.View

addChildrenForAccessibility, addFocusables, addFocusables, addOnAttachStateChangeListener, addOnLayoutChangeListener, addTouchables, animate, announceForAccessibility, bringToFront, buildDrawingCache, buildDrawingCache, buildLayer, callOnClick, cancelLongPress, cancelPendingInputEvents, canResolveLayoutDirection, canResolveTextAlignment, canResolveTextDirection, canScrollHorizontally, canScrollVertically, checkInputConnectionProxy, clearAnimation, clearFocus, combineMeasuredStates, computeScroll, computeSystemWindowInsets, createAccessibilityNodeInfo, createContextMenu, destroyDrawingCache, dispatchApplyWindowInsets, dispatchConfigurationChanged, dispatchDisplayHint, dispatchDragEvent, dispatchDrawableHotspotChanged, dispatchGenericMotionEvent, dispatchKeyEvent, dispatchKeyEventPreIme, dispatchKeyShortcutEvent, dispatchNestedFling, dispatchNestedPreFling, dispatchNestedPrePerformAccessibilityAction, dispatchNestedPreScroll, dispatchNestedScroll, dispatchPopulateAccessibilityEvent, dispatchProvideStructure, dispatchSystemUiVisibilityChanged, dispatchTouchEvent, dispatchTrackballEvent, dispatchUnhandledMove, dispatchWindowFocusChanged, dispatchWindowSystemUiVisiblityChanged, dispatchWindowVisibilityChanged, draw, drawableHotspotChanged, findFocus, findViewById, findViewsWithText, findViewWithTag, focusSearch, forceLayout, generateViewId, getAccessibilityClassName, getAccessibilityLiveRegion, getAccessibilityNodeProvider, getAccessibilityTraversalAfter, getAccessibilityTraversalBefore, getAlpha, getAnimation, getApplicationWindowToken, getBackground, getBackgroundTintList, getBackgroundTintMode, getBaseline, getBottom, getCameraDistance, getClipBounds, getClipBounds, getClipToOutline, getContentDescription, getContext, getDefaultSize, getDisplay, getDrawableState, getDrawingCache, getDrawingCache, getDrawingCacheBackgroundColor, getDrawingCacheQuality, getDrawingRect, getDrawingTime, getElevation, getFilterTouchesWhenObscured, getFitsSystemWindows, getFocusables, getFocusedRect, getForeground, getForegroundGravity, getForegroundTintList, getForegroundTintMode, getGlobalVisibleRect, getGlobalVisibleRect, getHandler, getHeight, getHitRect, getHorizontalFadingEdgeLength, getId, getImportantForAccessibility, getKeepScreenOn, getKeyDispatcherState, getLabelFor, getLayerType, getLayoutDirection, getLayoutParams, getLeft, getLocalVisibleRect, getLocationInWindow, getLocationOnScreen, getMatrix, getMeasuredHeight, getMeasuredHeightAndState, getMeasuredState, getMeasuredWidth, getMeasuredWidthAndState, getMinimumHeight, getMinimumWidth, getNextFocusDownId, getNextFocusForwardId, getNextFocusLeftId, getNextFocusRightId, getNextFocusUpId, getOnFocusChangeListener, getOutlineProvider, getOverlay, getOverScrollMode, getPaddingBottom, getPaddingEnd, getPaddingLeft, getPaddingRight, getPaddingStart, getPaddingTop, getParent, getParentForAccessibility, getPivotX, getPivotY, getResources, getRight, getRootView, getRootWindowInsets, getRotation, getRotationX, getRotationY, getScaleX, getScaleY, getScrollBarDefaultDelayBeforeFade, getScrollBarFadeDuration, getScrollBarSize, getScrollBarStyle, getScrollIndicators, getScrollX, getScrollY, getSolidColor, getStateListAnimator, getSystemUiVisibility, getTag, getTag, getTextAlignment, getTextDirection, getTop, getTouchables, getTouchDelegate, getTransitionName, getTranslationX, getTranslationY, getTranslationZ, getVerticalFadingEdgeLength, getVerticalScrollbarPosition, getVerticalScrollbarWidth, getViewTreeObserver, getVisibility, getWidth, getWindowId, getWindowSystemUiVisibility, getWindowToken, getWindowVisibility, getWindowVisibleDisplayFrame, getX, getY, getZ, hasFocus, hasFocusable, hasNestedScrollingParent, hasOnClickListeners, hasOverlappingRendering, hasTransientState, hasWindowFocus, inflate, invalidate, invalidate, invalidate, invalidateDrawable, invalidateOutline, isAccessibilityFocused, isActivated, isAttachedToWindow, isClickable, isContextClickable, isDirty, isDrawingCacheEnabled, isDuplicateParentStateEnabled, isEnabled, isFocusable, isFocusableInTouchMode, isFocused, isHapticFeedbackEnabled, isHardwareAccelerated, isHorizontalFadingEdgeEnabled, isHorizontalScrollBarEnabled, isHovered, isImportantForAccessibility, isInEditMode, isInLayout, isInTouchMode, isLaidOut, isLayoutDirectionResolved, isLayoutRequested, isLongClickable, isNestedScrollingEnabled, isOpaque, isPaddingRelative, isPressed, isSaveEnabled, isSaveFromParentEnabled, isScrollbarFadingEnabled, isScrollContainer, isSelected, isShown, isSoundEffectsEnabled, isTextAlignmentResolved, isTextDirectionResolved, isVerticalFadingEdgeEnabled, isVerticalScrollBarEnabled, jumpDrawablesToCurrentState, layout, measure, offsetLeftAndRight, offsetTopAndBottom, onApplyWindowInsets, onCancelPendingInputEvents, onCheckIsTextEditor, onCreateInputConnection, onDragEvent, onDrawForeground, onFilterTouchEventForSecurity, onFinishTemporaryDetach, onGenericMotionEvent, onHoverChanged, onHoverEvent, onInitializeAccessibilityEvent, onInitializeAccessibilityNodeInfo, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyPreIme, onKeyShortcut, onKeyUp, onPopulateAccessibilityEvent, onProvideStructure, onProvideVirtualStructure, onRtlPropertiesChanged, onScreenStateChanged, onStartTemporaryDetach, onTouchEvent, onTrackballEvent, onWindowFocusChanged, onWindowSystemUiVisibilityChanged, performAccessibilityAction, performClick, performContextClick, performHapticFeedback, performHapticFeedback, performLongClick, playSoundEffect, post, postDelayed, postInvalidate, postInvalidate, postInvalidateDelayed, postInvalidateDelayed, postInvalidateOnAnimation, postInvalidateOnAnimation, postOnAnimation, postOnAnimationDelayed, refreshDrawableState, removeCallbacks, removeOnAttachStateChangeListener, removeOnLayoutChangeListener, requestApplyInsets, requestFitSystemWindows, requestFocus, requestFocus, requestFocus, requestFocusFromTouch, requestLayout, requestRectangleOnScreen, requestRectangleOnScreen, requestUnbufferedDispatch, resolveSize, resolveSizeAndState, restoreHierarchyState, saveHierarchyState, scheduleDrawable, scrollBy, scrollTo, sendAccessibilityEvent, sendAccessibilityEventUnchecked, setAccessibilityDelegate, setAccessibilityLiveRegion, setAccessibilityTraversalAfter, setAccessibilityTraversalBefore, setActivated, setAlpha, setAnimation, setBackground, setBackgroundColor, setBackgroundDrawable, setBackgroundResource, setBackgroundTintList, setBackgroundTintMode, setBottom, setCameraDistance, setClickable, setClipBounds, setClipToOutline, setContentDescription, setContextClickable, setDrawingCacheBackgroundColor, setDrawingCacheEnabled, setDrawingCacheQuality, setDuplicateParentStateEnabled, setElevation, setEnabled, setFadingEdgeLength, setFilterTouchesWhenObscured, setFitsSystemWindows, setFocusable, setFocusableInTouchMode, setForeground, setForegroundGravity, setForegroundTintList, setForegroundTintMode, setHapticFeedbackEnabled, setHasTransientState, setHorizontalFadingEdgeEnabled, setHorizontalScrollBarEnabled, setHovered, setId, setImportantForAccessibility, setKeepScreenOn, setLabelFor, setLayerPaint, setLayerType, setLayoutDirection, setLayoutParams, setLeft, setLongClickable, setMinimumHeight, setMinimumWidth, setNestedScrollingEnabled, setNextFocusDownId, setNextFocusForwardId, setNextFocusLeftId, setNextFocusRightId, setNextFocusUpId, setOnApplyWindowInsetsListener, setOnClickListener, setOnContextClickListener, setOnCreateContextMenuListener, setOnDragListener, setOnFocusChangeListener, setOnGenericMotionListener, setOnHoverListener, setOnKeyListener, setOnLongClickListener, setOnScrollChangeListener, setOnSystemUiVisibilityChangeListener, setOnTouchListener, setOutlineProvider, setOverScrollMode, setPadding, setPaddingRelative, setPivotX, setPivotY, setPressed, setRight, setRotation, setRotationX, setRotationY, setSaveEnabled, setSaveFromParentEnabled, setScaleX, setScaleY, setScrollBarDefaultDelayBeforeFade, setScrollBarFadeDuration, setScrollbarFadingEnabled, setScrollBarSize, setScrollBarStyle, setScrollContainer, setScrollIndicators, setScrollIndicators, setScrollX, setScrollY, setSelected, setSoundEffectsEnabled, setStateListAnimator, setSystemUiVisibility, setTag, setTag, setTextAlignment, setTextDirection, setTop, setTouchDelegate, setTransitionName, setTranslationX, setTranslationY, setTranslationZ, setVerticalFadingEdgeEnabled, setVerticalScrollBarEnabled, setVerticalScrollbarPosition, setVisibility, setWillNotCacheDrawing, setWillNotDraw, setX, setY, setZ, showContextMenu, startActionMode, startActionMode, startAnimation, startDrag, startNestedScroll, stopNestedScroll, toString, unscheduleDrawable, unscheduleDrawable, willNotCacheDrawing, willNotDraw

Methods inherited from class java.lang.Object

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

Constructor Detail

GaugeRadialNeedle

public GaugeRadialNeedle(Context context)

Creates an instance of the GaugeRadialNeedle class.

Parameters:

context - the context to be used

GaugeRadialNeedle

public GaugeRadialNeedle(Context context,
                         AttributeSet attrs)

Creates an instance of the GaugeRadialNeedle class.

Parameters:

context - the context to be used

attrs - the attributes

GaugeRadialNeedle

public GaugeRadialNeedle(Context context,
                         AttributeSet attrs,
                         int defStyleAttr)

Creates an instance of the GaugeRadialNeedle class.

Parameters:

context - the context to be used

attrs - the attributes

defStyleAttr - the default style

Method Detail

getLength

public float getLength()

Returns the length of the needle. The returned value will be normalized (between 0 and 1).

Returns:

A float value representing the length of the needle.

setLength

public void setLength(float length)

Sets the length of the needle. Should be normalized value where 1 would be the whole radius of the view.

Parameters:

length - A float value between 0 and 1 that represents the length of the needle.

getBottomWidth

public float getBottomWidth()

Returns the width of the bottom end of the needle.

Returns:

A float value.

setBottomWidth

public void setBottomWidth(float bottomWidth)

Sets the bottom width of the needle. The needle will be invalidated.

Parameters:

bottomWidth - A float value.

getTopWidth

public float getTopWidth()

Returns the width of the needle pointing end.

Returns:

A float value.

setTopWidth

public void setTopWidth(float topWidth)

Sets the width of the needles pointing end. The needle will be invalidated.

Parameters:

topWidth - A float value.

getCircleRadius

public float getCircleRadius()

Returns the outer radius of the needle's circle.

Returns:

A float value.

setCircleRadius

public void setCircleRadius(float circleRadius)

Sets the outer radius of the needle's circle. The needle will be invalidated.

Parameters:

circleRadius - A float value.

getCircleInnerRadius

public float getCircleInnerRadius()

Returns the circle's inned radius.

Returns:

A float value.

setCircleInnerRadius

public void setCircleInnerRadius(float circleInnerRadius)

Sets the inner radius of the circle.

Parameters:

circleInnerRadius - A float value.

getOffset

public float getOffset()

Returns the offset of the needle from the circle.

Returns:

A float value.

setOffset

public void setOffset(float offset)

Sets the offset of the needle from the circle. Positive value will draw the pointing end of the needle closer the the circle while negative will draw it far from the circle. The needle will be invalidated.

Parameters:

offset - A float value.

getCircleFillPaint

public Paint getCircleFillPaint()

Returns the Paint used to fill the needle's circle.

Returns:

A Paint object.

setCircleFillPaint

public void setCircleFillPaint(Paint circleFillPaint)

Sets the Paint used to fill the circle. The needle will be invalidated.

Parameters:

circleFillPaint - A Paint object.

getCircleFillColor

public int getCircleFillColor()

Returns an integer that represents the fill color of the circle.

Returns:

An integer value.

setCircleFillColor

public void setCircleFillColor(int circleFillColor)

Sets the color used to fill the circle of the needle. The needle will be invalidated.

Parameters:

circleFillColor - An integer value.

getCircleStrokePaint

public Paint getCircleStrokePaint()

Returns the Paint used to draw the circle's stroke.

Returns:

A Paint object.

setCircleStrokePaint

public void setCircleStrokePaint(Paint circleStrokePaint)

Sets the Paint used to draw circle's stroke. The needle will be invalidated.

Parameters:

circleStrokePaint - A Paint object.

getCircleStrokeColor

public int getCircleStrokeColor()

Returns an integer that represents the stroke color of the circle.

Returns:

An integer value.

setCircleStrokeColor

public void setCircleStrokeColor(int circleStrokeColor)

Sets the color used to stroke the circle of the needle. The needle will be invalidated.

Parameters:

circleStrokeColor - An integer value.

getCircleStrokeWidth

public float getCircleStrokeWidth()

Returns the needle's circle stroke width.

Returns:

The circle's stroke width value.

setCircleStrokeWidth

public void setCircleStrokeWidth(float circleStrokeWidth)

Sets the circle's stroke width. The needle will be invalidated.

Parameters:

circleStrokeWidth - A float value.

getValue

public float getValue()

Returns tha value of the needle.

Returns:

A float value.

setValue

public void setValue(float value)

Sets the value of the needle. The value is used to draw the needle towards its scale. If animations are switched on changing the value of the needle will animate it as well.

Parameters:

value - A float value.

getAnimationStartValue

public float getAnimationStartValue()

Returns the start value used when animating the needle.

Returns:

A float value.

setAnimationStartValue

public void setAnimationStartValue(float animationStartValue)

Sets the start value from which the animation will begin when the needle value is changed. If not set, the animations start value would be either needle's scale minimum value or the last value of the needle.

Parameters:

animationStartValue - A float value.

startAnimation

public void startAnimation()

Description copied from class: GaugeIndicator

Starts animating the indicator if the animations are on.

Overrides:

startAnimation in class GaugeIndicator