# WheelView

**Repository Path**: chinasoft5_ohos/WheelView

## Basic Information

- **Project Name**: WheelView
- **Description**: No description available
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-07-23
- **Last Updated**: 2021-09-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WheelView

## 项目介绍
- 项目名称：WheelView
- 所属系列：openharmony的第三方组件适配移植
- 功能：滚轮控件，基于滑动列表实现，可以自定义样式
- 项目移植状态：主功能完成
- 调用差异：无
- 开发版本：sdk6，DevEco Studio2.2 beta1
- 基线版本：Release 1.3.3
## 效果演示

![演示效果](https://images.gitee.com/uploads/images/2021/0723/171125_76c881e6_8695913.gif "截图.gif")

## 安装教程

1.在项目根目录下的build.gradle文件中，

 ```

allprojects {

    repositories {

        maven {

            url 'https://s01.oss.sonatype.org/content/repositories/releases/'

        }

    }

}

 ```

2.在entry模块的build.gradle文件中，

 ```

 dependencies {

        implementation('com.gitee.chinasoft_ohos:wheelview:1.0.0')

    ......  

 }

 ```

在sdk6，DevEco Studio2.2 beta1下项目可直接运行
如无法运行，删除项目.gradle,.idea,build,gradle,build.gradle文件，
并依据自己的版本创建新项目，将新项目的对应文件复制到根目录下

## 使用说明

1.将仓库导入到本地仓库中

2.新增MainAbility继承Ability,代码实例如下:
Java:
```Java
    public class MainAbility extends Ability {
        @Override
        public void onStart(Intent intent) {
            super.onStart(intent);
            setUIContent(ResourceTable.Layout_ability_main);

            WheelView wheelView = (WheelView) findComponentById(ResourceTable.Id_wheelview);
            wheelView.setWheelAdapter(new ArrayWheelAdapter(this)); // 文本数据源
            wheelView.setSkin(WheelView.Skin.Common); // common皮肤
            wheelView.setWheelData(list);  // 数据集合

        }
    }
```

XML:
```xml
    <com.wx.wheelview.widget.WheelView
            ohos:id="$+id:wheelview"
            ohos:height="match_parent"
            ohos:width="match_content"/>
```

Methods:
| method 方法          | description 描述 |
|:---				 |:---|
| void **setWheelAdapter**(BaseWheelAdapter<T> adapter)  	     | 设置滚轮数据源适配器（required） |
| void **setWheelData**(List<T> list)  	     | 设置滚轮数据（required） |
| void **setLoop**(boolean loop)  	     | 设置滚轮是否循环滚动 |
| void **setWheelSize**(int wheelSize) 	     | 设置滚轮个数 |
| void **setSkin**(Skin skin) 	     | 设置皮肤风格 |
| Skin **getSkin**()  	     | 获得皮肤风格 |
| void **setStyle**(WheelViewStyle style)  	     | 设置滚轮样式 |
| WheelViewStyle **getStyle**()  	     | 获得滚轮样式 |
| void **setWheelClickable**(boolean clickable)  	     | 设置滚轮选中项是否可点击 |
| void **setSelection**(final int selection) 	     | 设置滚轮位置 |
| int **getSelection**() 	     | 获取滚轮位置 |
| void **join**(WheelView wheelView)  	     | 连接副WheelView（联动设置） |
| void **joinDatas**(HashMap<String, List<T>> map)	     | 副WheelView数据（联动设置） |
| int **getCurrentPosition**()  	     | 获取当前滚轮位置 |
| T **getSelectionItem**()  	     | 获取当前滚轮位置的数据 |
| void **setExtraText**(String text, int textColor, int textSize, int margin)     	     | 设置选中行附加文本 |
| int **getWheelCount**() 	     | 获得滚轮数据总数 |
| void **setOnWheelItemSelectedListener**(OnWheelItemSelectedListener<T> onWheelItemSelectedListener) | 设置滚轮滑动停止时事件，监听滚轮选中项 |
| void **setOnWheelItemClickListener**(OnWheelItemClickListener<T> onWheelItemClickListener) | 设置滚轮选中项点击事件 |
| WheelViewDialog **setDialogStyle**(int color) | 设置Dialog外观颜色 |

## 测试信息

CodeCheck代码测试无异常

CloudTest代码测试无异常

病毒安全检测通过

当前版本demo功能与原组件基本无差异

## 版本迭代

- 1.0.0
- 0.0.1-SNAPSHOT

## 版权和许可信息

```
Copyright (C) 2016 venshine.cn@gmail.com

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.