From 37663db137819c4d23936c758d17d96dcc7b806b Mon Sep 17 00:00:00 2001
From: Hemal Patel <hemalp@google.com>
Date: Mon, 13 Jun 2016 14:37:36 -0700
Subject: Docs: Added overview of Custom Pointer API

Bug: 28241984
Change-Id: Iffa2a0cc46f71377b79f4ac792d2f469353cc395
---
 docs/html/preview/api-overview.jd | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/html/preview/api-overview.jd b/docs/html/preview/api-overview.jd
index 4abd95634b90..f2bc11136d58 100644
--- a/docs/html/preview/api-overview.jd
+++ b/docs/html/preview/api-overview.jd
@@ -37,6 +37,7 @@ page.image=images/cards/card-n-apis_2x.png
         <li><a href="#apk_signature_v2">APK Signature Scheme v2</a></li>
         <li><a href="#scoped_directory_access">Scoped Directory Access</a></li>
         <li><a href="#keyboard_shortcuts_helper">Keyboard Shortcuts Helper</a></li>
+        <li><a href="#custom_pointer_api">Custom Pointer API</a></li>
         <li><a href="#sustained_performance_api">Sustained Performance API</a></li>
         <li><a href="#vr">VR Support</a></li>
         <li><a href="#print_svc">Print Service Enhancements</a></li>
@@ -865,6 +866,26 @@ Directory Access</a> developer documentation.</p>
   {@code Activity.requestKeyboardShortcutsHelper()} for the relevant activity.
 </p>
 
+<h2 id="custom_pointer_api">
+  Custom Pointer API
+</h2>
+
+<p>
+  Android N introduces the Custom Pointer API, which lets you customize the
+  appearance, visibility, and behavior of the pointer. This capability is
+  especially useful when a user is using a mouse or touchpad to interact with
+  UI objects. The default pointer uses a standard icon. This API also includes
+  advanced functionality such as changing the pointer icon's appearance based
+  on specific mouse or touchpad movements.
+</p>
+
+<p>
+  To set a pointer icon, override the <code>onResolvePointerIcon()</code>
+  method of the <code>View</code> class. This method uses a
+  <code>PointerIcon</code> object to draw the icon that corresponds to a
+  specific motion event.
+</p>
+
 <h2 id="sustained_performance_api">Sustained Performance API</h2>
 
 <p>
-- 
cgit v1.2.3-59-g8ed1b