149b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn/* 249b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * Copyright (C) 2015 The Android Open Source Project 349b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * 449b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * Licensed under the Apache License, Version 2.0 (the "License"); 549b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * you may not use this file except in compliance with the License. 649b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * You may obtain a copy of the License at 749b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * 849b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * http://www.apache.org/licenses/LICENSE-2.0 949b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * 1049b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * Unless required by applicable law or agreed to in writing, software 1149b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * distributed under the License is distributed on an "AS IS" BASIS, 1249b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1349b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * See the License for the specific language governing permissions and 1449b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * limitations under the License. 1549b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn */ 1649b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 1749b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackbornpackage android.view; 1849b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 1970d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackbornimport android.graphics.Matrix; 2049b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackbornimport android.graphics.Rect; 2149b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackbornimport android.os.Bundle; 2249b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 2349b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn/** 2449b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * Container for storing additional per-view data generated by {@link View#onProvideStructure 2549b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn * View.onProvideStructure}. 2649b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn */ 2749b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackbornpublic abstract class ViewStructure { 2802beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 2902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the identifier for this view. 3002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * 3102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @param id The view's identifier, as per {@link View#getId View.getId()}. 3202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @param packageName The package name of the view's identifier, or null if there is none. 3302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @param typeName The type name of the view's identifier, or null if there is none. 3402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @param entryName The entry name of the view's identifier, or null if there is none. 3502beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 3649b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setId(int id, String packageName, String typeName, String entryName); 3749b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 3802beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 3902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the basic dimensions of this view. 4002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * 4102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @param left The view's left position, in pixels relative to its parent's left edge. 4202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @param top The view's top position, in pixels relative to its parent's top edge. 4302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @param scrollX How much the view's x coordinate space has been scrolled, in pixels. 4402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @param scrollY How much the view's y coordinate space has been scrolled, in pixels. 4502beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @param width The view's visible width, in pixels. This is the width visible on screen, 4602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * not the total data width of a scrollable view. 4702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @param height The view's visible height, in pixels. This is the height visible on 4802beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * screen, not the total data height of a scrollable view. 4902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 5049b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setDimens(int left, int top, int scrollX, int scrollY, int width, 5149b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn int height); 5249b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 5302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 5470d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn * Set the transformation matrix associated with this view, as per 5570d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn * {@link View#getMatrix View.getMatrix()}, or null if there is none. 5670d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn */ 5770d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn public abstract void setTransformation(Matrix matrix); 5870d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn 5970d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn /** 6070d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn * Set the visual elevation (shadow) of the view, as per 6170d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn * {@link View#getZ View.getZ()}. Note this is <em>not</em> related 6270d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn * to the physical Z-ordering of this view relative to its other siblings (that is how 6370d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn * they overlap when drawing), it is only the visual representation for shadowing. 6470d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn */ 6570d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn public abstract void setElevation(float elevation); 6670d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn 6770d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn /** 6870d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn * Set an alpha transformation that is applied to this view, as per 6970d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn * {@link View#getAlpha View.getAlpha()}. Value ranges from 0 7070d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn * (completely transparent) to 1 (completely opaque); the default is 1, which means 7170d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn * no transformation. 7270d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn */ 7370d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn public abstract void setAlpha(float alpha); 7470d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn 7570d8be7616a450e9b7ef09c8bda5a8b25936a29aDianne Hackborn /** 7602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the visibility state of this view, as per 7702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * {@link View#getVisibility View.getVisibility()}. 7802beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 7949b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setVisibility(int visibility); 8049b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 8149b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn /** @hide */ 8249b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setAssistBlocked(boolean state); 8349b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 8402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 8502beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the enabled state of this view, as per {@link View#isEnabled View.isEnabled()}. 8602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 8749b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setEnabled(boolean state); 8849b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 8902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 9002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the clickable state of this view, as per {@link View#isClickable View.isClickable()}. 9102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 9249b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setClickable(boolean state); 9349b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 9402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 9502beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the long clickable state of this view, as per 9602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * {@link View#isLongClickable View.isLongClickable()}. 9702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 9849b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setLongClickable(boolean state); 9949b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 10002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 101e860891b1a7d4c1b581f294fa5831999caac6506Mady Mellor * Set the context clickable state of this view, as per 102e860891b1a7d4c1b581f294fa5831999caac6506Mady Mellor * {@link View#isContextClickable View.isContextClickable()}. 10302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 104e860891b1a7d4c1b581f294fa5831999caac6506Mady Mellor public abstract void setContextClickable(boolean state); 10549b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 10602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 10702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the focusable state of this view, as per {@link View#isFocusable View.isFocusable()}. 10802beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 10949b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setFocusable(boolean state); 11049b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 11102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 11202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the focused state of this view, as per {@link View#isFocused View.isFocused()}. 11302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 11449b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setFocused(boolean state); 11549b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 11602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 11702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the accessibility focused state of this view, as per 11802beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * {@link View#isAccessibilityFocused View.isAccessibilityFocused()}. 11902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 12049b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setAccessibilityFocused(boolean state); 12149b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 12202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 12302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the checkable state of this view, such as whether it implements the 12402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * {@link android.widget.Checkable} interface. 12502beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 12649b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setCheckable(boolean state); 12749b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 12802beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 12902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the checked state of this view, such as 13002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * {@link android.widget.Checkable#isChecked Checkable.isChecked()}. 13102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 13249b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setChecked(boolean state); 13349b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 13402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 13502beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the selected state of this view, as per {@link View#isSelected View.isSelected()}. 13602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 13749b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setSelected(boolean state); 13849b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 13902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 14002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the activated state of this view, as per {@link View#isActivated View.isActivated()}. 14102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 14249b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setActivated(boolean state); 14349b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 14402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 14502beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the class name of the view, as per 14602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * {@link View#getAccessibilityClassName View.getAccessibilityClassName()}. 14702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 14849b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setClassName(String className); 14949b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 15002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 15102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the content description of the view, as per 15202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * {@link View#getContentDescription View.getContentDescription()}. 15302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 15449b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setContentDescription(CharSequence contentDescription); 15549b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 15602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 15702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the text that is associated with this view. There is no selection 15802beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * associated with the text. The text may have style spans to supply additional 15902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * display and semantic information. 16002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 16149b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setText(CharSequence text); 16202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn 16302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 16402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Like {@link #setText(CharSequence)} but with an active selection 16502beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * extending from <var>selectionStart</var> through <var>selectionEnd</var>. 16602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 16749b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setText(CharSequence text, int selectionStart, int selectionEnd); 16802beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn 16902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 17002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Explicitly set default global style information for text that was previously set with 17102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * {@link #setText}. 17202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * 17302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @param size The size, in pixels, of the text. 17402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @param fgColor The foreground color, packed as 0xAARRGGBB. 17502beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @param bgColor The background color, packed as 0xAARRGGBB. 17616036f26847f3f1a88a093fb776bf081008ff8d8Dianne Hackborn * @param style Style flags, as defined by {@link android.app.assist.AssistStructure.ViewNode}. 17702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 1785cfaae4aae744574f0fcc0876cdc5473bc1a344dJames Cook public abstract void setTextStyle(float size, int fgColor, int bgColor, int style); 17902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn 18002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 1816f0fdc4167ad906fc7409856e86cd0cc601c3b53Dianne Hackborn * Set line information for test that was previously supplied through 1826f0fdc4167ad906fc7409856e86cd0cc601c3b53Dianne Hackborn * {@link #setText(CharSequence)}. This provides the line breaking of the text as it 1836f0fdc4167ad906fc7409856e86cd0cc601c3b53Dianne Hackborn * is shown on screen. This function takes ownership of the provided arrays; you should 1846f0fdc4167ad906fc7409856e86cd0cc601c3b53Dianne Hackborn * not make further modification to them. 1856f0fdc4167ad906fc7409856e86cd0cc601c3b53Dianne Hackborn * 1866f0fdc4167ad906fc7409856e86cd0cc601c3b53Dianne Hackborn * @param charOffsets The offset in to {@link #setText} where a line starts. 1876f0fdc4167ad906fc7409856e86cd0cc601c3b53Dianne Hackborn * @param baselines The baseline where the line is drawn on screen. 1886f0fdc4167ad906fc7409856e86cd0cc601c3b53Dianne Hackborn */ 1896f0fdc4167ad906fc7409856e86cd0cc601c3b53Dianne Hackborn public abstract void setTextLines(int[] charOffsets, int[] baselines); 1906f0fdc4167ad906fc7409856e86cd0cc601c3b53Dianne Hackborn 1916f0fdc4167ad906fc7409856e86cd0cc601c3b53Dianne Hackborn /** 19202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set optional hint text associated with this view; this is for example the text that is 19302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * shown by an EditText when it is empty to indicate to the user the kind of text to input. 19402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 19549b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setHint(CharSequence hint); 19649b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 19702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 19802beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Retrieve the last {@link #setText(CharSequence)}. 19902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 20049b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract CharSequence getText(); 20102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn 20202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 20302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Retrieve the last selection start set by {@link #setText(CharSequence, int, int)}. 20402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 20549b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract int getTextSelectionStart(); 20602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn 20702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 20802beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Retrieve the last selection end set by {@link #setText(CharSequence, int, int)}. 20902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 21049b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract int getTextSelectionEnd(); 21102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn 21202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 21302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Retrieve the last hint set by {@link #setHint}. 21402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 21549b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract CharSequence getHint(); 21649b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 21702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 21802beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Get extra data associated with this view structure; the returned Bundle is mutable, 21902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * allowing you to view and modify its contents. Keys placed in the Bundle should use 22002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * an appropriate namespace prefix (such as com.google.MY_KEY) to avoid conflicts. 22102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 22249b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract Bundle getExtras(); 22302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn 22402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 22502beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Returns true if {@link #getExtras} has been used to create extra content. 22602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 22749b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract boolean hasExtras(); 22849b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 22902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 23002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Set the number of children of this view, which defines the range of indices you can 23102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * use with {@link #newChild} and {@link #asyncNewChild}. Calling this method again 23202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * resets all of the child state of the view, removing any children that had previously 23302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * been added. 23402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 23549b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void setChildCount(int num); 23602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn 23702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 238ece0f4f5198e9e9cb60e96f036baf22c73411becDianne Hackborn * Add to this view's child count. This increases the current child count by 239ece0f4f5198e9e9cb60e96f036baf22c73411becDianne Hackborn * <var>num</var> children beyond what was last set by {@link #setChildCount} 240ece0f4f5198e9e9cb60e96f036baf22c73411becDianne Hackborn * or {@link #addChildCount}. The index at which the new child starts in the child 241ece0f4f5198e9e9cb60e96f036baf22c73411becDianne Hackborn * array is returned. 242ece0f4f5198e9e9cb60e96f036baf22c73411becDianne Hackborn * 243ece0f4f5198e9e9cb60e96f036baf22c73411becDianne Hackborn * @param num The number of new children to add. 244ece0f4f5198e9e9cb60e96f036baf22c73411becDianne Hackborn * @return Returns the index in the child array at which the new children start. 245ece0f4f5198e9e9cb60e96f036baf22c73411becDianne Hackborn */ 246ece0f4f5198e9e9cb60e96f036baf22c73411becDianne Hackborn public abstract int addChildCount(int num); 247ece0f4f5198e9e9cb60e96f036baf22c73411becDianne Hackborn 248ece0f4f5198e9e9cb60e96f036baf22c73411becDianne Hackborn /** 24902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Return the child count as set by {@link #setChildCount}. 25002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 25149b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract int getChildCount(); 25202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn 25302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 25402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Create a new child {@link ViewStructure} in this view, putting into the list of 25502beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * children at <var>index</var>. 25602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @return Returns an fresh {@link ViewStructure} ready to be filled in. 25702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 2588ecf16d186fa8606571b75c01a21a528a7e55d23Dianne Hackborn public abstract ViewStructure newChild(int index); 25949b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 26002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 26102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Like {@link #newChild}, but allows the caller to asynchronously populate the returned 26202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * child. It can transfer the returned {@link ViewStructure} to another thread for it 26302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * to build its content (and children etc). Once done, some thread must call 26402beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * {@link #asyncCommit} to tell the containing {@link ViewStructure} that the async 26502beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * population is done. 26602beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * @return Returns an fresh {@link ViewStructure} ready to be filled in. 26702beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 2688ecf16d186fa8606571b75c01a21a528a7e55d23Dianne Hackborn public abstract ViewStructure asyncNewChild(int index); 26902beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn 27002beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn /** 27102beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * Call when done populating a {@link ViewStructure} returned by 27202beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn * {@link #asyncNewChild}. 27302beb41c97a44a3333b1e9eca9033e91282d887dDianne Hackborn */ 27449b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract void asyncCommit(); 27549b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn 27649b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn /** @hide */ 27749b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn public abstract Rect getTempRect(); 27849b043f37d7231b1544cb72e1bfb616e5a00688dDianne Hackborn} 279