SmartClipProvider.java revision 1320f92c476a1ad9d19dba2a48c72b75566198e9 
1// Copyright 2014 The Chromium Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5package org.chromium.content.browser;
6
7import android.os.Handler;
8
9import org.chromium.base.UsedByReflection;
10
11/**
12 * An interface to provide smart clip data when requested.
13 *
14 * NOTE: Some platforms may call these functions to extract smart clip data.
15 * Please make sure implementation of them is somewhere in the view
16 * hierarchy.
17 */
18@UsedByReflection("ExternalOemSupport")
19public interface SmartClipProvider {
20    /**
21     * Initiate extraction of text, HTML, and other information for clipping puposes (smart clip)
22     * from the rectangle area defined by starting positions (x and y), and width and height.
23     */
24    @UsedByReflection("ExternalOemSupport")
25    void extractSmartClipData(int x, int y, int width, int height);
26
27    /**
28     * Register a handler to handle smart clip data once extraction is done.
29     */
30    @UsedByReflection("ExternalOemSupport")
31    void setSmartClipResultHandler(final Handler resultHandler);
32}
33