public class GuidedAction
extends Action
java.lang.Object | ||
↳ | android.support.v17.leanback.widget.Action | |
↳ | android.support.v17.leanback.widget.GuidedAction |
Known Direct Subclasses |
表示GuidedStepFragment
内的动作的数据类。 GuidedActions包含至少一个标题和一个描述,通常也是一个图标。
GuidedAction通常表示用户可能采取的单个动作,但也可以表示一组互斥选项(类似于单选按钮)或仅信息标签(在这种情况下该项目不能被点击)中的可能选择, 。
GuidedActions可以选择性地被检查。 他们也可能会表示他们会在选择时要求更多的用户输入,在这种情况下,他们将显示一个V形指示符。
GuidedAction建议使用GuidedAction.Builder
。 当应用程序子类GuidedAction时,它可以GuidedAction.BuilderBase
,实现它自己的builder()方法,它应该调用applyValues(GuidedAction)
。
Nested classes |
|
---|---|
class |
GuidedAction.Builder 构建一个 |
class |
GuidedAction.BuilderBase<B extends BuilderBase> 基础构建器类构建一个 |
Constants |
|
---|---|
long |
ACTION_ID_CANCEL 标准取消操作的标识。 |
long |
ACTION_ID_CONTINUE 标准完成操作的标识。 |
long |
ACTION_ID_CURRENT 完成编辑后,请继续进行当前操作。 |
long |
ACTION_ID_FINISH 标准完成操作的标识。 |
long |
ACTION_ID_NEXT 完成编辑后,转到下一个动作。 |
long |
ACTION_ID_NO 标准没有行动的标识。 |
long |
ACTION_ID_OK 标准OK行为的标识。 |
long |
ACTION_ID_YES 标准是行动的标识。 |
int |
CHECKBOX_CHECK_SET_ID Checkset Id复选框。 |
int |
DEFAULT_CHECK_SET_ID 收音机的默认检查集ID。 |
int |
NO_CHECK_SET 特殊检查集ID既不是复选框也不是收音机。 |
Inherited constants |
---|
From class android.support.v17.leanback.widget.Action
|
Protected constructors |
|
---|---|
GuidedAction() |
Public methods |
|
---|---|
int |
getCheckSetId() 返回此操作所属的检查集ID。 |
CharSequence |
getDescription() 返回此操作的描述。 |
int |
getDescriptionEditInputType() 返回编辑中动作描述的InputType; 仅在 |
int |
getDescriptionInputType() 返回操作说明的InputType不在编辑中。 |
CharSequence |
getEditDescription() 返回可选的描述文本进行编辑。 |
int |
getEditInputType() 返回编辑中动作标题的InputType; 只有当 |
CharSequence |
getEditTitle() 返回可选标题文本以进行编辑。 |
int |
getInputType() 返回操作标题的InputType不在编辑中。 |
Intent |
getIntent() 返回与此操作关联的意图。 |
List<GuidedAction> |
getSubActions() |
CharSequence |
getTitle() 返回此操作的标题。 |
boolean |
hasEditableActivatorView() 返回是否可以激活此操作以进行编辑,例如 |
boolean |
hasMultilineDescription() 返回此操作是否具有多行描述。 |
boolean |
hasNext() 返回选择时此操作是否会请求进一步的用户输入,例如显示另一个GuidedStepFragment或启动新的活动。 |
boolean |
hasSubActions() |
boolean |
hasTextEditable() 如果此操作具有可编辑标题或可编辑描述,则返回。 |
boolean |
infoOnly() 返回操作是否仅显示信息,因此无法点击。 |
final boolean |
isAutoSaveRestoreEnabled() 如果Action将保存到instanceState并稍后恢复,则返回true,否则返回false。 |
boolean |
isChecked() 返回是否选中此操作。 |
boolean |
isDescriptionEditable() 返回此操作描述是否可编辑。 |
boolean |
isEditTitleUsed() 如果 |
boolean |
isEditable() 返回此操作标题是否可编辑。 |
boolean |
isEnabled() 返回是否启用此操作。 |
boolean |
isFocusable() 返回此操作是否可以调焦。 |
void |
onRestoreInstanceState(Bundle bundle, String key) 使用给定键从软件包中恢复操作。 |
void |
onSaveInstanceState(Bundle bundle, String key) 使用给定的键将操作保存到一个包中。 |
void |
setChecked(boolean checked) 设置是否检查此操作。 |
void |
setDescription(CharSequence description) 设置此操作的描述。 |
void |
setEditDescription(CharSequence editDescription) 将可选说明文字设置为编辑而不是 |
void |
setEditTitle(CharSequence editTitle) 将可选标题文本设置为编辑而不是 |
void |
setEnabled(boolean enabled) 设置是否启用此操作。 |
void |
setFocusable(boolean focusable) 设置此操作是否可以调整。 |
void |
setIntent(Intent intent) 设置此操作的意图。 |
void |
setSubActions(List<GuidedAction> actions) 更改子动作列表。 |
void |
setTitle(CharSequence title) 设置此操作的标题。 |
Inherited methods |
|
---|---|
From class android.support.v17.leanback.widget.Action
|
|
From class java.lang.Object
|
long ACTION_ID_CANCEL
标准取消操作的标识。
常量值:-5(0xfffffffffffffffb)
long ACTION_ID_CONTINUE
标准完成操作的标识。
常量值:-7(0xfffffffffffffff9)
long ACTION_ID_CURRENT
完成编辑后,请继续进行当前操作。
常量值:-3(0xfffffffffffffffd)
long ACTION_ID_FINISH
标准完成操作的标识。
常量值:-6(0xfffffffffffffffa)
long ACTION_ID_NEXT
完成编辑后,转到下一个动作。
常量值:-2(0xfffffffffffffffe)
long ACTION_ID_NO
标准没有行动的标识。
常量值:-9(0xfffffffffffffff7)
long ACTION_ID_OK
标准OK行为的标识。
常量值:-4(0xfffffffffffffffc)
long ACTION_ID_YES
标准是行动的标识。
常数值:-8(0xfffffffffffffff8)
int CHECKBOX_CHECK_SET_ID
Checkset Id复选框。
常量值:-1(0xffffffff)
int DEFAULT_CHECK_SET_ID
收音机的默认检查集ID。
常数值:1(0x00000001)
int NO_CHECK_SET
特殊检查集ID既不是复选框也不是收音机。
常量值:0(0x00000000)
GuidedAction ()
int getCheckSetId ()
返回此操作所属的检查集ID。 具有相同检查集ID的同一列表中的所有操作都被视为链接。 当选择该组中的某个动作时,该动作将被检查,而所有其他动作均未被选中。
Returns | |
---|---|
int |
an integer representing the check set this action is a part of, or CHECKBOX_CHECK_SET_ID if this is a checkbox, or NO_CHECK_SET if this action is not a checkbox or radiobutton. |
CharSequence getDescription ()
返回此操作的描述。
Returns | |
---|---|
CharSequence |
The description of this action. |
int getDescriptionEditInputType ()
返回编辑中动作描述的InputType; 只有当isDescriptionEditable()
为真时才有效。
Returns | |
---|---|
int |
InputType of action description in editing. |
int getDescriptionInputType ()
返回操作说明的InputType不在编辑中。
Returns | |
---|---|
int |
InputType of action description not in editing. |
CharSequence getEditDescription ()
返回可选的描述文本进行编辑。 当不为空时,它将被编辑而不是getDescription()
。
Returns | |
---|---|
CharSequence |
Optional description text to edit instead of getDescription() . |
int getEditInputType ()
返回编辑中动作标题的InputType; 只有当isEditable()
为真时才有效。
Returns | |
---|---|
int |
InputType of action title in editing. |
CharSequence getEditTitle ()
返回可选标题文本以进行编辑。 当不为空时,它将被编辑而不是getTitle()
。
Returns | |
---|---|
CharSequence |
Optional title text to edit instead of getTitle() . |
int getInputType ()
返回操作标题的InputType不在编辑中。
Returns | |
---|---|
int |
InputType of action title not in editing. |
Intent getIntent ()
返回与此操作关联的意图。
Returns | |
---|---|
Intent |
The intent set when this action was built. |
List<GuidedAction> getSubActions ()
Returns | |
---|---|
List<GuidedAction> |
List of sub actions or null if sub actions list is not enabled. |
CharSequence getTitle ()
返回此操作的标题。
Returns | |
---|---|
CharSequence |
The title set when this action was built. |
boolean hasEditableActivatorView ()
返回是否可以激活此操作以进行编辑,例如DatePicker。
Returns | |
---|---|
boolean |
true if the action can be activated to edit. |
boolean hasMultilineDescription ()
返回此操作是否具有多行描述。
Returns | |
---|---|
boolean |
true if the action was constructed as having a multiline description, false otherwise. |
boolean hasNext ()
返回选择时此操作是否会请求进一步的用户输入,例如显示另一个GuidedStepFragment或启动新的活动。 在施工期间进行配置。
Returns | |
---|---|
boolean |
true if the action will request further user input when selected, false otherwise. |
boolean hasSubActions ()
Returns | |
---|---|
boolean |
True if has sub actions list, even it's currently empty. |
boolean hasTextEditable ()
如果此操作具有可编辑标题或可编辑描述,则返回。
Returns | |
---|---|
boolean |
True if this action has editable title or editable description, false otherwise. |
boolean infoOnly ()
返回操作是否仅显示信息,因此无法点击。 如果this和hasNext()
都是true,则infoOnly优先。 默认值是false。 例如,这可能表示例如文档使用的存储量或应用程序的成本。
Returns | |
---|---|
boolean |
true if will only display information, false otherwise. |
boolean isAutoSaveRestoreEnabled ()
如果Action将保存到instanceState并稍后恢复,则返回true,否则返回false。 默认值是true。 当isAutoSaveRestoreEnabled()为true并且getId()
不是NO_ID
:
isEditable()
is true: save text of getTitle()
isDescriptionEditable()
is true: save text of getDescription()
getCheckSetId()
is not NO_CHECK_SET
: save isChecked()
}GuidedDatePickerAction
will be savedReturns | |
---|---|
boolean |
True if Action will be saved to instanceState and restored later, false otherwise. |
boolean isChecked ()
返回是否选中此操作。
Returns | |
---|---|
boolean |
true if the action is currently checked, false otherwise. |
boolean isDescriptionEditable ()
返回此操作描述是否可编辑。
Returns | |
---|---|
boolean |
true if the action description is editable, false otherwise. |
boolean isEditTitleUsed ()
如果getEditTitle()
不为null,则返回true。 如果为true,则getEditTitle()
正在编辑的代替getTitle()
。
Returns | |
---|---|
boolean |
true if getEditTitle() is not null. |
boolean isEditable ()
返回此操作标题是否可编辑。
Returns | |
---|---|
boolean |
true if the action title is editable, false otherwise. |
boolean isEnabled ()
返回是否启用此操作。
Returns | |
---|---|
boolean |
true if the action is currently enabled, false otherwise. |
boolean isFocusable ()
返回此操作是否可以调焦。
Returns | |
---|---|
boolean |
true if the action is currently focusable, false otherwise. |
void onRestoreInstanceState (Bundle bundle, String key)
Restore action from a bundle using a given key. When isAutoRestore() is true:
isEditable()
is true: save text of getTitle()
isDescriptionEditable()
is true: save text of getDescription()
getCheckSetId()
is not NO_CHECK_SET
: save isChecked()
}GuidedDatePickerAction
will be savedParameters | |
---|---|
bundle |
Bundle : Bundle to restore the Action from. |
key |
String : Key used to restore the Action. |
void onSaveInstanceState (Bundle bundle, String key)
Save action into a bundle using a given key. When isAutoRestoreEna() is true:
isEditable()
is true: save text of getTitle()
isDescriptionEditable()
is true: save text of getDescription()
getCheckSetId()
is not NO_CHECK_SET
: save isChecked()
}GuidedDatePickerAction
will be savedParameters | |
---|---|
bundle |
Bundle : Bundle to save the Action. |
key |
String : Key used to save the Action. |
void setChecked (boolean checked)
设置是否检查此操作。
Parameters | |
---|---|
checked |
boolean : Whether this action should be checked. |
void setDescription (CharSequence description)
设置此操作的描述。
Parameters | |
---|---|
description |
CharSequence : The description of the action. |
void setEditDescription (CharSequence editDescription)
设置可选的描述文本来编辑,而不是 setDescription(CharSequence)
。
Parameters | |
---|---|
editDescription |
CharSequence : Optional description text to edit instead of setDescription(CharSequence) . |
void setEditTitle (CharSequence editTitle)
将可选标题文本设置为编辑而不是 setTitle(CharSequence)
。
Parameters | |
---|---|
editTitle |
CharSequence : Optional title text to edit instead of setTitle(CharSequence) . |
void setEnabled (boolean enabled)
设置是否启用此操作。
Parameters | |
---|---|
enabled |
boolean : Whether this action should be enabled. |
void setFocusable (boolean focusable)
设置此操作是否可以调整。
Parameters | |
---|---|
focusable |
boolean : Whether this action should be focusable. |
void setIntent (Intent intent)
设置此操作的意图。
Parameters | |
---|---|
intent |
Intent : New intent to set on this action. |
void setSubActions (List<GuidedAction> actions)
更改子动作列表。
Parameters | |
---|---|
actions |
List : Sub actions list to set on this action. Sets null to disable sub actions. |
void setTitle (CharSequence title)
设置此操作的标题。
Parameters | |
---|---|
title |
CharSequence : The title set when this action was built. |