# ContactPicker

**Repository Path**: dsapr/ContactPicker

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-04-16
- **Last Updated**: 2021-11-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ContactPicker

[![License](https://img.shields.io/badge/license-Apache%202-green.svg)](https://www.apache.org/licenses/LICENSE-2.0)

##介绍 Introduction##
**ContactPicker** - 仿 Android 联系人列表界面的 Demo ，具有快速索引功能和搜索功能。(The Demo of imitation Android contact list UI with fast indexing and search capabilities.)

##截图 Screenshot##
![screenshot_gif](https://github.com/yuqirong/ContactPicker/blob/master/screenshots/screenshots.gif)

##下载 Demo Download##
安装后请确保该应用有读取联系人权限。(After installation make sure that the application has permission to read contacts.)

[Download](https://github.com/yuqirong/ContactPicker/blob/master/screenshots/app-debug-unaligned.apk)

##博客 Blog##
[《快速打造仿Android联系人界面》](http://yuqirong.me/2016/03/22/%E5%BF%AB%E9%80%9F%E6%89%93%E9%80%A0%E4%BB%BFAndroid%E8%81%94%E7%B3%BB%E4%BA%BA%E7%95%8C%E9%9D%A2/)

##用法 Usage##
###step 1###
把QuickIndexBar控件添加到你的布局文件中。(Include the QuickIndexBar widget in your layout.)

	<com.yuqirong.contactpicker.view.QuickIndexBar
        android:id="@+id/qib"
        android:layout_width="25dp"
        android:layout_height="match_parent"
        android:layout_alignParentRight="true"
        android:background="#aa000000" />

###step 2###
可以在`onCreate(Bundle savedInstanceState)`中添加`OnIndexChangeListener`。具体使用方法可以参考代码。(You can add the `OnIndexChangeListener` for `QuickIndexBar` in `onCreate(Bundle savedInstanceState)`.Specific methods can refer to the code.)

	qib.setOnIndexChangeListener(new QuickIndexBar.OnIndexChangeListener() {
			@Override
			public void onIndexChange(int section) {
				...
			}

			@Override
			public void onActionUp() {
				...
			}
		});

好了，享受吧！(Well, enjoy it!)

##自定义属性 Customization##
你可在下面属性中自定义任何你想要的。(You can customize any of the following properties you want.)

| Name          | format        | Description |
| ------------- |:-------------:| -----------:|
| font_color      | color\|reference       | 字体颜色(Font Color) |
| selected_font_color     | color\|reference      | 选中时字体的颜色(Selected Font Color) |
| font_size | dimension\|reference     | 字体大小(Font Size) |


##联系方式 Contact Me##
新浪微博 Sina Weibo：[@活得好像一条狗](http://weibo.com/yyyuqirong) 

电子邮箱 Email：<yqr271228943@gmail.com>

If you have any questions or want to contact me,you can also leave a message in [Issues](https://github.com/yuqirong/ContactPicker/issues).

##开源许可证 License##

    Copyright (c) 2016 yuqirong 

    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.