JustWeTools - 自定义控件集

JustWeTools - Some useful tools

项目地址

JustWe 如今有哪些模块?

• View自定义控件
  • PaintView画图工具(包含重构压感新版)
  • CodeView代码编辑
    
  • ExplorerView文件管理器
  • ReadView小说阅读器
    
  • MarkDownView支持MarkDown语法的文字渲染器
    
  • VerTextView支持竖行排版/下划线的TextView
    
  • FlashTextView仿QQ的流光字体
    
  • Progress进度条/环形进度条
    
  • Clock 绘制时钟
• Utils工具类
  • AlarmUtil 闹钟事件工具类
  • MPUtils 短信电话工具类
  • NetUtils 网络状态工具类
  • PicUtils 图片处理工具类
  • ServiceUtils 服务工具类
  • ImageHelper 图型处理类
    
  • DisplayUtils 数据转换类
  • SpUtils Sp简化工具类（可存储list和map）
  • ToastUtils Toast定制工具类
  • ValidatorsUtils 正则表达式处理类

模块如何使用：

• 将Demo做为library加入项目，或是直接将代码拷入
  
• 下载demo ：apk-demo

JustWe 模块介绍:

View自定义控件:

PaintView画图工具:

• 可直接使用设定按钮来实现已拥有的方法，且拓展性强
• 基础功能：更换颜色、更换橡皮、以及更换橡皮和笔的粗细、清屏、倒入图片
• 特殊功能：保存画笔轨迹帧动画、帧动画导入导出、ReDo和UnDo
• 重构版本：提供笔刷类型基类DrawBase，可继承此类制做笔刷

效果图：

使用基础功能只须要：

1.1 添加xml：

<com.lfk.justwetools.View.PaintIt.PaintView
       android:id="@+id/paintView"
       android:layout_width="match_parent"
       android:layout_height="match_parent" />

1.2 在activity里找到：

paintView = (PaintView)findViewById(R.id.paint);

若想使用帧动画相关功能：

须要新建数据集，设定纪录paintview，而且设定onPathListener（）

pathNode = (PathNode)getApplication();
    paintView.setIsRecordPath(true,pathNode);
    paintView.setOnPathListener(new OnPathListener() {
        @Override
    public void AddNodeToPath(float x, float y, int event, boolean IsPaint) {
        PathNode.Node tempnode = pathNode.new Node();
        tempnode.x = x;
        tempnode.y = y;
        if (IsPaint) {
            tempnode.PenColor = UserInfo.PaintColor;
            tempnode.PenWidth = UserInfo.PaintWidth;
        } else {
            tempnode.EraserWidth = UserInfo.EraserWidth;
        }
        tempnode.IsPaint = IsPaint;
        Log.e(tempnode.PenColor + ":" + tempnode.PenWidth + ":" +       tempnode.EraserWidth, tempnode.IsPaint + "");
        tempnode.TouchEvent = event;
        tempnode.time = System.currentTimeMillis();
        pathNode.AddNode(tempnode);
        }
    });

相关的教程和解析请看：PaintView 绘图控件解析
图例中出现的Demo: 图例Demo
图例中使用了两个开源控件:
CircularFloatingActionMenu 和 android-ColorPickerPreference

---

CodeView代码查看／修改工具:

• 基于WebView制做的代码编辑器
• 实现代码高亮，暗色主题
• 代码及时修改

效果图：

使用基础功能只须要：

2.1 添加xml：

<com.lfk.justwetools.View.CodeView.CodeView
        android:id="@+id/mcodeview"
        android:layerType="hardware"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

2.2 在Activity中获取路径：

codeView = (CodeView)findViewById(R.id.mcodeview);

        File dir = null;
        Uri fileUri = getIntent().getData();
        if (fileUri != null) {
            dir = new File(fileUri.getPath());
        }

        if (dir != null) {
            codeView.setDirSource(dir);
            getSupportActionBar().setSubtitle(dir.getName());
        }
        else
            finish();

若是是手动复制代码的话，须要复制assests文件夹下的js文件。

2.3 编辑修改：

@Override
    public boolean onOptionsItemSelected(MenuItem item) {
        int id = item.getItemId();
        if (item.getItemId() == R.id.action_code) {
            if (!codeView.isEditable()) {
                item.setTitle("完成");
                codeView.setContentEditable(true);
            } else {
                item.setTitle("编辑");
                codeView.setContentEditable(false);
            }
        }
        return super.onOptionsItemSelected(item);
    }

---

ExplorerView 文件浏览器：

• 继承自ListView
• 可拓展性强
• 可进行文件类型分析

效果图：

• 使用基础功能

3.1 添加xml：

<com.lfk.justwetools.View.FileExplorer.FileExplorer
        android:id="@+id/ex"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

3.2 在Activity里面：

fileExplorer = (FileExplorer)findViewById(R.id.ex);

此时默认的打开路径为sd卡根目录：
可经过以下修改：

// 打开路径
    fileExplorer.setCurrentDir(Environment.getExternalStorageDirectory().getPath());
    // 根路径（能到达最深的路径，以此避免用户进入root路径）
    fileExplorer.setRootDir(Environment.getExternalStorageDirectory().getPath());

Item的点击事件：

//覆盖屏蔽原有长按事件
        fileExplorer.setOnItemLongClickListener(new AdapterView.OnItemLongClickListener() {
            @Override
            public boolean onItemLongClick(AdapterView<?> parent, View view, int position, long id) {
                return false;
            }
        });
        //选择文件 默认打开CodeView
        fileExplorer.setOnFileChosenListener(new OnFileChosenListener() {
            @Override
            public void onFileChosen(Uri fileUri) {
                Intent intent = new Intent(ExplorerActivity.this, CodeActivity.class);
                intent.setData(fileUri);
                startActivity(intent);
            }
        });

返回键返回上一级：

@Override
    public boolean onKeyDown(int keyCode, KeyEvent event) {
        if (keyCode == KeyEvent.KEYCODE_BACK
                && event.getAction() == KeyEvent.ACTION_DOWN) {
            if(!fileExplorer.toParentDir()){
                if(System.currentTimeMillis() - exitTime < 1000)
                    finish();
                exitTime = System.currentTimeMillis();
                Toast.makeText(this, "再次点击退出", Toast.LENGTH_SHORT).show();
            }
            return true;
        }
        return super.onKeyDown(keyCode, event);
    }

高级功能:

根据文件夹内的各类文件类型的大小比例，分析比例图，不建议在sd卡根目录使用内容过多反应较慢.

3.3 添加xml：

<com.lfk.justwetools.View.Proportionview.ProportionView
        android:id="@+id/pv"
        android:layout_margin="10dp"
        android:layout_width="match_parent"
        android:layout_height="30dp" />

3.4 在Activity中添加：

final ProportionView view = (ProportionView) findViewById(R.id.pv);

注册分析文件比例的接口：

//新路径下分析文件比例
    fileExplorer.setOnPathChangedListener(new OnPathChangedListener() {
        @Override
        public void onPathChanged(String path) {
            try {
                view.setData(fileExplorer.getPropotionText(path));
            } catch (Exception e) {
                Toast.makeText(getApplicationContext(), "此路径下不可访问或文件夹下无文件", Toast.LENGTH_LONG).show();
            }
        }
    });

---

ReadView小说阅读：

• 基于Canvas制做的小说阅读
  
• 可更换字体、字号、字颜色
• 拓展性强

效果图：

使用基础功能只须要：

ReadView readView = new ReadView(this,dir.getPath());
   setContentView(readView);

若是须要打开文件时调用请修改manifest和：

File dir = null;
        Uri fileUri = getIntent().getData();
        if (fileUri != null) {
            dir = new File(fileUri.getPath());
        }
        readView = null;
        if (dir != null) {
            readView = new ReadView(this,dir.getPath());
        }
        else
            finish();
        setContentView(readView);

---

MarkDownView支持MarkDown语法的渲染器:

• 基于WebView的MarkDown渲染器
  
• 支持标准化的MarkDown语法
• 调用接口和CodeView保持一导致用简便

效果图:

使用基础功能:

<com.lfk.justwetools.View.MarkDown.MarkDownView
        android:id="@+id/markdownview"
        android:layout_width="match_parent"
        android:layout_height="match_parent">
    </com.lfk.justwetools.View.MarkDown.MarkDownView>

并添加:

MarkDownView markDownView = (MarkDownView)findViewById(R.id.markdownview);
        if(getIntent().getStringExtra("str") != null){
            markDownView.setStringSource(getIntent().getStringExtra("str"));
        }

若是须要打开文件时调用请修改manifest和：

File dir = null;
        Uri fileUri = getIntent().getData();
        if (fileUri != null) {
            dir = new File(fileUri.getPath());
        }

        if (dir != null) {
            markDownView.setDirSource(dir);
        }

---

VerTextView竖行排版的TextView:

• 支持竖行排版
• 添加了下划线功能，开启简便，下划线粗细、颜色、间距都可自定义
• 接口调用方式与TextView类似，使用简便

效果图:

使用基础功能:

<com.lfk.justwetools.View.VerText.VerTextView
    android:id="@+id/vertextview"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />

并添加:

VerTextView verTextView = (VerTextView)findViewById(R.id.vertextview);
    verTextView.setText(getResources().getString(R.string.poem));

一些设定:

verTextView.setFontSize(100);             // 设定字体尺寸
    verTextView.setIsOpenUnderLine(true);     // 设定开启下划线
    verTextView.setUnderLineColor(Color.RED); // 设定下划线颜色
    verTextView.setUnderLineWidth(3);         // 设定下划线宽度
    verTextView.setUnderLineSpacing(10);      // 设定下划线到字的间距
    verTextView.setTextStartAlign(VerTextView.RIGHT); // 从右侧或左侧开始排版
    verTextView.setTextColor(color);           // 设定字体颜色
    ...

---

Clock 绘制时钟:自定义View绘制的时钟

<com.lfk.justwetools.View.Clock.Clock
        android:id="@+id/clock"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_below="@id/flashTextView"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="16dp" />

一些设定：

void setColor(int color);
    void setNeedleColor(int needleColor);
    void setTextColor(int textColor);
    void setCircleColor(int circleColor);
    void setUnthehourLineColor(int unthehourLineColor);
    void setThehourLineColor(int thehourLineColor);
    void setHourSize(int hourSize);
    ...

---

有问题反馈

在使用中有任何问题，欢迎反馈给我，能够用如下联系方式跟我交流

• 邮件:lfk_dsk@hotmail.com
  
• weibo: @亦狂亦侠_亦温文
  
• 博客: 刘丰恺

License

Copyright 2015 [刘丰恺](http://www.cnblogs.com/lfk-dsk/)

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.