Support for "go to hour" added

Author: alamkanak

README.md

@@ -31,14 +31,14 @@ Usage
     <dependency>
       <groupId>com.github.alamkanak</groupId>
       <artifactId>android-week-view</artifactId>
-      <version>1.1.6</version>
+      <version>1.1.7</version>
       <type>aar</type>
     </dependency>
     ```
   * Grab via gradle
 
     ```groovy
-    compile 'com.github.alamkanak:android-week-view:1.1.6'
+    compile 'com.github.alamkanak:android-week-view:1.1.7'
     ```
 2. Add WeekView in your xml layout.
 
@@ -132,6 +132,10 @@ To do
 Changelog
 ---------
 
+**Version 1.1.7**
+
+* You can now dynamically scroll to an hour of your preference.
+
 **Version 1.1.6**
 
 * Added support for events that expands to multiple days

gradle.properties

@@ -1,4 +1,4 @@
-VERSION_NAME=1.1.6
+VERSION_NAME=1.1.7
 GROUP=com.github.alamkanak
 
 POM_DESCRIPTION=Dissect layout traversals on Android.

library/src/main/java/com/alamkanak/weekview/WeekView.java

@@ -1215,6 +1215,23 @@ public void notifyDatasetChanged(){
         invalidate();
     }
 
+    /**
+     * Vertically scroll to a specific hour in the week view.
+     * @param hour The hour to scroll to in 24-hour format. Supported values are 0-24.
+     */
+    public void goToHour(double hour){
+        if (hour < 0)
+            throw new IllegalArgumentException("Cannot scroll to an hour of negative value.");
+        else if (hour > 24)
+            throw new IllegalArgumentException("Cannot scroll to an hour of value greater than 24.");
+        else if (hour * mHourHeight > mHourHeight * 24 - getHeight() + mHeaderTextHeight + mHeaderRowPadding * 2 + mHeaderMarginBottom)
+            throw new IllegalArgumentException("Cannot scroll to an hour which will result the calendar to go off the screen.");
+
+        int verticalOffset = (int) (mHourHeight * hour);
+        mCurrentOrigin.y = -verticalOffset;
+        invalidate();
+    }
+
 
 
     /////////////////////////////////////////////////////////////////