| OLD | NEW |
| 1 /* Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 /* Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 2 * Use of this source code is governed by a BSD-style license that can be | 2 * Use of this source code is governed by a BSD-style license that can be |
| 3 * found in the LICENSE file. | 3 * found in the LICENSE file. |
| 4 */ | 4 */ |
| 5 | 5 |
| 6 /** | 6 /** |
| 7 * This file defines the <code>PPB_TextInput_Dev</code> interface. | 7 * This file defines the <code>PPB_TextInput_Dev</code> interface. |
| 8 */ | 8 */ |
| 9 | 9 |
| 10 label Chrome { | 10 label Chrome { |
| (...skipping 55 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 66 /** | 66 /** |
| 67 * Cancels the current composition in IME. | 67 * Cancels the current composition in IME. |
| 68 */ | 68 */ |
| 69 void CancelCompositionText([in] PP_Instance instance); | 69 void CancelCompositionText([in] PP_Instance instance); |
| 70 | 70 |
| 71 /** | 71 /** |
| 72 * In response to the <code>PPP_TextInput_Dev::RequestSurroundingText</code> | 72 * In response to the <code>PPP_TextInput_Dev::RequestSurroundingText</code> |
| 73 * call, informs the browser about the current text selection and surrounding | 73 * call, informs the browser about the current text selection and surrounding |
| 74 * text. <code>text</code> is a UTF-8 string that contains the current range | 74 * text. <code>text</code> is a UTF-8 string that contains the current range |
| 75 * of text selection in the plugin. <code>caret</code> is the byte-index of | 75 * of text selection in the plugin. <code>caret</code> is the byte-index of |
| 76 * the caret poisition within <code>text</code>. <code>anchor</code> is the | 76 * the caret position within <code>text</code>. <code>anchor</code> is the |
| 77 * byte-index of the anchor position (i.e., if a range of text is selected, | 77 * byte-index of the anchor position (i.e., if a range of text is selected, |
| 78 * it is the other edge of selection diffrent from <code>caret</code>. If | 78 * it is the other edge of selection different from <code>caret</code>. If |
| 79 * there are no selection, <code>anchor</code> is equal to <code>caret</code>. | 79 * there are no selection, <code>anchor</code> is equal to <code>caret</code>. |
| 80 * | 80 * |
| 81 * Typical use of this information in the browser is to enable "reconversion" | 81 * Typical use of this information in the browser is to enable "reconversion" |
| 82 * features of IME that puts back the already committed text into the | 82 * features of IME that puts back the already committed text into the |
| 83 * pre-commit composition state. Another use is to improve the precision | 83 * pre-commit composition state. Another use is to improve the precision |
| 84 * of suggestion of IME by taking the context into account (e.g., if the caret | 84 * of suggestion of IME by taking the context into account (e.g., if the caret |
| 85 * looks to be on the begining of a sentense, suggest capital letters in a | 85 * looks to be on the beginning of a sentence, suggest capital letters in a |
| 86 * virtual keyboard). | 86 * virtual keyboard). |
| 87 * | 87 * |
| 88 * When the focus is not on text, call this function setting <code>text</code> | 88 * When the focus is not on text, call this function setting <code>text</code> |
| 89 * to an empty string and <code>caret</code> and <code>anchor</code> to zero. | 89 * to an empty string and <code>caret</code> and <code>anchor</code> to zero. |
| 90 * Also, the plugin should send the empty text when it does not want to reveal | 90 * Also, the plugin should send the empty text when it does not want to reveal |
| 91 * the selection to IME (e.g., when the surrounding text is containing | 91 * the selection to IME (e.g., when the surrounding text is containing |
| 92 * password text). | 92 * password text). |
| 93 */ | 93 */ |
| 94 [version=0.2] | 94 [version=0.2] |
| 95 void UpdateSurroundingText([in] PP_Instance instance, | 95 void UpdateSurroundingText([in] PP_Instance instance, |
| 96 [in] str_t text, | 96 [in] str_t text, |
| 97 [in] uint32_t caret, | 97 [in] uint32_t caret, |
| 98 [in] uint32_t anchor); | 98 [in] uint32_t anchor); |
| 99 | 99 |
| 100 /** | 100 /** |
| 101 * Informs the browser when a range of text selection is changed in a plugin. | 101 * Informs the browser when a range of text selection is changed in a plugin. |
| 102 * When the browser needs to know the content of the updated selection, it | 102 * When the browser needs to know the content of the updated selection, it |
| 103 * pings back by <code>PPP_TextInput_Dev::RequestSurroundingText</code>. The | 103 * pings back by <code>PPP_TextInput_Dev::RequestSurroundingText</code>. The |
| 104 * plugin then should send the information with | 104 * plugin then should send the information with |
| 105 * <code>UpdateSurroundingText</code>. | 105 * <code>UpdateSurroundingText</code>. |
| 106 */ | 106 */ |
| 107 [version=0.2] | 107 [version=0.2] |
| 108 void SelectionChanged([in] PP_Instance instance); | 108 void SelectionChanged([in] PP_Instance instance); |
| 109 }; | 109 }; |
| OLD | NEW |