Android 自定义 View 刻度尺

项目地址:

ScaleView 项目地址

简介:

适用于Android的刻度尺(标尺)控件。高度自定义内存占用低,纯绘制,不使用动画。

目录:

1.使用方式

2.使用示例

3.自定义属性

4.方法

5.监听

1.使用方式

使用方式一:Maven方式:

Step 1. 在 project 层级的 build.gradle 中,添加仓库地址:
allprojects {
    repositories {
        ...
        jcenter()
    }
}
Step 2. 在主 module 的 build.gradle 中添加依赖:
  • 最新版本
implementation 'com.chiului.library:scaleview:1.1.1'

使用方式二:Module 方式

Step 1. 下载源码
Step 2. 引入 Module

File --> New --> import Module

Step 3. 在主 Module 中添加 Module 依赖
implementation project(path: ':scaleview')

2.使用示例

示例1 示例2 示例3 示例4

2.1仅改变各种颜色样式:





2.2某项目内样式:





2.3显示负数、向下视图、隐藏底线样式:





2.4显示整数、居中视图、隐藏指针头样式:





3.自定义属性


属性 作用 默认值
name="min_index" format="integer" 最小刻度 0
name="max_index" format="integer" 最大刻度 100
name="now_index" format="integer" 当前刻度 50
name="scale_value" format="integer" 每格刻度的值 1
name="text_size" format="float" 刻度数值的字体大小 50f
name="pointer_width" format="float" 指针线宽度 3f
name="pointer_head" format="float" 指针头宽度 30
name="pointer_top" format="boolean" 指针是否向上 true
name="pointer_top_protruding" format="boolean" 指针是否向上突出 false
name="pointer_bottom_protruding" format="boolean" 指针是否向下突出(相对于刻度线来说,如下对齐情况中,指针线下面要长于刻度线) false
name="show_pointer_head" format="boolean" 是否显示针头 true
name="baseLine_width" format="float" 底线线宽度 5f
name="low_scale_width" format="float" 低刻度线宽度 1f
name="middle_scale_width" format="float" 中刻度线宽度 2f
name="high_scale_width" format="float" 高刻度线宽度 3f
name="line_interval" format="integer" 刻度与刻度之间的距离 30
name="baseLine_margin_bottom" format="integer" 所有元素(除了文字)与 View 底的距离(下边距为文字留位置) 50
name="pointer_margin_top" format="integer" 所有元素(除了文字)与 View 顶的距离(上边距为文字留位置) 50
name="left_margin_left" format="integer" 所有元素(除了文字)与 View 左边的距离 0
name="right_margin_right" format="integer" 所有元素(除了文字)与 View 右边的距离 0
name="font_margin_bottom" format="integer" 文字下边距(避免显示不全) 0
name="font_margin_top" format="integer" 文字上边距(避免显示不全) 40
name="low_pointer_margin" format="integer" 低刻度的边距(控制长度) 150
name="middle_pointer_margin" format="integer" 中刻度的边距(控制长度) 100
name="high_pointer_margin" format="integer" 高刻度的边距(控制长度) 50
name="middle_frequency" format="integer" 中刻度线频率 5
name="high_frequency" format="integer" 高刻度线频率 10
name="baseLine_color" format="color" 底线颜色 #C7C7C7
name="high_scale_color" format="color" 高刻度线颜色 #C7C7C7
name="middle_scale_color" format="color" 中刻度线颜色 #C7C7C7
name="low_scale_color" format="color" 低刻度线颜色 #C7C7C7
name="num_color" format="color" 刻度数值颜色 #01C5C6
name="pointer_color" format="color" 指针颜色 #FF8282
name="font_top" format="boolean" 字体是否要绘制在上面 true
name="scale_ratio" format="float" 显示的刻度数字与刻度比例(比如要显示小数的情况, 显示整数则设为 1):刻度 / 比例 = 显示刻度 10
name="sliding_ratio" format="float" 滑动距离比例(用于调整滑动速度):刻度间距离 * 滑动速度比例 = 每滑动多少距离改变状态 0.5
name="show_baseLine" format="boolean" 是否显示底线 true
name="units" format="float" 惯性滑动速率时间单位, 多少毫秒时间单位内运动了多少个像素 500
name="max_velocity" format="float" 最大滑动数率 15000
name="strokeCap" format="enum" Paint 的线帽: BUTT:无线帽,ROUND:圆角, SQUARE:矩形 SQUARE
name="scale_position" format="enum" 刻度线对齐:top:上对齐,center:居中对齐,bottom:下对齐 bottom

4.方法


方法 作用
setNowIndex(double) 设置刻度
setPlusScale() 加刻度
setMinusScale() 减刻度
setMaxIndex(double) 设置最小刻度范围
setMaxIndex(double) 设置最大刻度范围

5.监听


监听 作用
setOnScaleChangeListener(OnScaleChangeListener) 设置改变刻度回调监听

你可能感兴趣的:(Android 自定义 View 刻度尺)