/**@class android.content.ClipData.Item @extends java.lang.Object Description of a single item in a ClipData. <p>The types than an individual item can currently contain are:</p> <ul> <li> Text: a basic string of text. This is actually a CharSequence, so it can be formatted text supported by corresponding Android built-in style spans. (Custom application spans are not supported and will be stripped when transporting through the clipboard.) <li> Intent: an arbitrary Intent object. A typical use is the shortcut to create when pasting a clipped item on to the home screen. <li> Uri: a URI reference. This may be any URI (such as an http: URI representing a bookmark), however it is often a content: URI. Using content provider references as clips like this allows an application to share complex or large clips through the standard content provider facilities. </ul> */ var Item = { /**Retrieve the raw text contained in this Item. */ getText : function( ) {}, /**Retrieve the raw HTML text contained in this Item. */ getHtmlText : function( ) {}, /**Retrieve the raw Intent contained in this Item. */ getIntent : function( ) {}, /**Retrieve the raw URI contained in this Item. */ getUri : function( ) {}, /**Turn this item into text, regardless of the type of data it actually contains. <p>The algorithm for deciding what text to return is: <ul> <li> If {@link #getText} is non-null, return that. <li> If {@link #getUri} is non-null, try to retrieve its data as a text stream from its content provider. If this succeeds, copy the text into a String and return it. If it is not a content: URI or the content provider does not supply a text representation, return the raw URI as a string. <li> If {@link #getIntent} is non-null, convert that to an intent: URI and return it. <li> Otherwise, return an empty string. </ul> @param {Object {Context}} context The caller's Context, from which its ContentResolver and other things can be retrieved. @return {Object {java.lang.CharSequence}} Returns the item's textual representation. */ coerceToText : function( ) {}, /**Like {@link #coerceToHtmlText}(Context), but any text that would be returned as HTML formatting will be returned as text with style spans. @param {Object {Context}} context The caller's Context, from which its ContentResolver and other things can be retrieved. @return {Object {java.lang.CharSequence}} Returns the item's textual representation. */ coerceToStyledText : function( ) {}, /**Turn this item into HTML text, regardless of the type of data it actually contains. <p>The algorithm for deciding what text to return is: <ul> <li> If {@link #getHtmlText} is non-null, return that. <li> If {@link #getText} is non-null, return that, converting to valid HTML text. If this text contains style spans, {@link Html#toHtml(Spanned) Html.toHtml(Spanned)} is used to convert them to HTML formatting. <li> If {@link #getUri} is non-null, try to retrieve its data as a text stream from its content provider. If the provider can supply text/html data, that will be preferred and returned as-is. Otherwise, any text/* data will be returned and escaped to HTML. If it is not a content: URI or the content provider does not supply a text representation, HTML text containing a link to the URI will be returned. <li> If {@link #getIntent} is non-null, convert that to an intent: URI and return as an HTML link. <li> Otherwise, return an empty string. </ul> @param {Object {Context}} context The caller's Context, from which its ContentResolver and other things can be retrieved. @return {String} Returns the item's representation as HTML text. */ coerceToHtmlText : function( ) {}, /** */ toString : function( ) {}, /** @hide */ toShortString : function( ) {}, /** @hide */ toShortSummaryString : function( ) {}, /** @hide */ writeToProto : function( ) {}, };