树叶云鸿蒙OS教程：鸿蒙OS SearchBar

SearchBar

java.lang.Object

|—ohos.agp.components.Component

|—|—ohos.agp.components.ComponentContainer

|—|—|—ohos.agp.components.DirectionalLayout

|—|—|—|—ohos.agp.components.SearchBar

public class SearchBar
extends DirectionalLayout

提供用户界面，供用户通过输入字符串开始搜索并获取搜索结果。

搜索结果显示在列表中。 如果未找到匹配项，则结果为空。 默认情况下，搜索组件是一个图标。

Since:

3

嵌套类摘要

字段摘要

构造函数摘要

方法总结

构造函数详细信息

SearchBar

public SearchBar(Context context)

用于使用默认属性集和样式创建 SearchBar 实例的默认构造函数。

参数：

SearchBar

public SearchBar(Context context, AttrSet attrSet)

用于在解析 XML 文件后使用指定的属性集和默认样式创建 SearchBar 实例的构造函数。

参数：

SearchBar

public SearchBar(Context context, AttrSet attrSet, String styleName)

用于在解析 XML 文件后使用指定的属性集和指定的样式创建 SearchBar 实例的构造函数。

参数：

方法详情

addComponent

public void addComponent(Component childComponent)

通过在内部调用 ComponentContainer.addComponent(ohos.agp.components.Component,int index) 将组件添加到队列的末尾。

覆盖：

类 ComponentContainer 中的 addComponent

参数：

getSearchText

public TextField getSearchText()

获取此 SearchBar 的搜索文本。

返回:

返回搜索文本。

Since:

4

getSearchButton

public Image getSearchButton()

获取此 SearchBar 的搜索按钮。

返回:

返回搜索按钮。

Since:

4

getSearchIcon

public Image getSearchIcon()

获取此 SearchBar 的搜索图标。

返回:

返回搜索图标。

Since:

4

getSubmitButton

public Image getSubmitButton()

获取此 SearchBar 的提交按钮。

返回:

返回提交按钮。

Since:

4

getCloseButton

public Image getCloseButton()

获取此 SearchBar 的关闭按钮。

返回:

返回关闭按钮。

Since:

4

setTextSize

public void setTextSize(int textSize)

设置搜索栏的文本大小。

参数：

Since:

3

getTextSize

public int getTextSize()

获取搜索栏的文本大小。

返回:

返回搜索栏的文本大小。

Since:

3

setQuery

public void setQuery(String query, boolean submit)

设置搜索字符串和搜索模式。 提供两种搜索模式：立即开始搜索； 或仅更新搜索字符串，然后单击搜索按钮开始搜索。

参数：

Since:

3

getQuery

public String getQuery()

获取搜索栏中的搜索字符串。

返回:

返回搜索栏中的搜索字符串。

Since:

3

setSearchHint

public void setSearchHint(String searchHint)

设置在搜索框中显示的提示文本。

在初始化时或在用户提供任何搜索字符串之前，提示文本会显示在搜索框中。

参数：

Since:

4

getQueryHint

public String getQueryHint()

获取搜索栏中的提示文本。

返回:

返回搜索栏中显示的提示文本。

Since:

3

setMaxWidth

public void setMaxWidth(int maxPixels)

设置搜索栏的最大宽度，以像素为单位。

参数：

Since:

3

getMaxWidth

public int getMaxWidth()

获取为搜索栏指定的最大宽度。

返回:

返回搜索栏的最大宽度； 如果未指定最大宽度，则返回 0。

Since:

3

setIconifiedState

public void setIconifiedState(boolean state)

设置是图标化还是展开搜索栏。

参数：

Since:

4

getIconifiedState

public boolean getIconifiedState()

获取搜索栏的当前状态。

返回:

如果搜索栏被图标化，则返回 true； 如果展开则返回 false。

Since:

4

setFoldListener

public void setFoldListener(SearchBar.FoldListener listener)

设置一个侦听器以通知用户何时关闭 SearchBar。

参数：

Since:

3

getFoldListener

public SearchBar.FoldListener getFoldListener()

获取监听此 SearchBar 关闭的监听器。

返回:

返回监听器。

Since:

4

setQueryListener

public void setQueryListener(SearchBar.QueryListener listener)

设置侦听器以通知用户何时更改或提交搜索栏中的搜索字符串。

参数：

Since:

3

getQueryListener

public SearchBar.QueryListener getQueryListener()

获取监听此SearchBar中搜索字符串的更改或提交的监听器。

返回:

返回监听器。

Since:

4

setQueryFocusChangeListener

public void setQueryFocusChangeListener(Component.FocusChangedListener listener)

设置侦听器以通知查询文本字段的焦点何时更改。

参数：

Since:

3

setSearchClickListener

public void setSearchClickListener(Component.ClickedListener listener)

设置侦听器以在按下搜索按钮时进行通知。

参数：

Since:

3

getSearchClickListener

public Component.ClickedListener getSearchClickListener()

获取单击搜索按钮时发送的通知的侦听器。

返回:

返回获取的监听器。

Since:

4

activateSubmitButton

public void activateSubmitButton(boolean enabled)

指定如果查询不为空，提交按钮是否必须可用。

参数：

Since:

4

isSearchButtonEnable

public boolean isSearchButtonEnable()

必要时检查是否启用了提交按钮。

返回:

如果必要时自动启用提交按钮，则返回 true； 否则返回 false。

Since:

4

setSearchButton

public void setSearchButton(PixelMap pixelMap)

设置搜索按钮的 pixelMap。

参数：

Since:

4

setSearchIcon

public void setSearchIcon(PixelMap pixelMap)

设置搜索图标的 pixelMap。

参数：

Since:

4

setCloseButton

public void setCloseButton(PixelMap pixelMap)

设置关闭按钮的图像 URI。

参数：

Since:

4

setSubmitButton

public void setSubmitButton(PixelMap pixelMap)

设置提交按钮的pixelMap。

参数：

Since:

4

setSearchButton

public void setSearchButton(int resId)

设置搜索按钮的图像资源 ID。

参数：

Since:

4

setSearchIcon

public void setSearchIcon(int resId)

设置搜索图标的图像资源 ID。

参数：

Since:

4

setSubmitButton

public void setSubmitButton(int resId)

设置提交按钮的图像资源 ID。

参数：

Since:

4

setCloseButton

public void setCloseButton(int resId)

设置关闭按钮的图像资源 ID。

参数：

Since:

4

setSearchTextColor

public void setSearchTextColor(Color color)

设置搜索框的文本颜色。

参数：

getSearchTextColor

public Color getSearchTextColor()

获取搜索框的文字颜色。

返回:

返回文本颜色。

Since:

4