程序包 ohos.agp.window.dialog

类 PopupDialog

java.lang.Object

ohos.agp.window.dialog.BaseDialog

ohos.agp.window.dialog.PopupDialog

所有已实现的接口:

IDialog

public class PopupDialog
extends BaseDialog

Creates popup dialogs that are used with specific components.

从以下版本开始:

1

嵌套类概要

从类继承的嵌套类/接口 ohos.agp.window.dialog.BaseDialog

BaseDialog.DialogListener, BaseDialog.DisplayCallback, BaseDialog.RemoveCallback

从接口继承的嵌套类/接口 ohos.agp.window.dialog.IDialog

IDialog.CheckBoxClickedListener, IDialog.ClickedListener, IDialog.ItemClickedListener, IDialog.KeyboardCallback

字段概要

从接口继承的字段 ohos.agp.window.dialog.IDialog

BUTTON_NUM, BUTTON1, BUTTON2, BUTTON3, DEF_RADIUS, ICON_NUM, ICON1, ICON2, ICON3

构造器概要

构造器

构造器	说明
PopupDialog(Context context, Component contentComponent)	A constructor used to create a PopupDialog instance with the width and height of the contentComponent.
PopupDialog(Context context, Component contentComponent, int width, int height)	A constructor used to create a PopupDialog instance with the specified width and height.

方法概要

限定符和类型	方法	说明
protected void	onShow()	Callback interface used when showing a Dialog instance.
protected void	onShowing()	Called when the pre-layout of a dialog box is complete and the content is being shown in the dialog box.
void	setArrowOffset(int offset)	Sets the arrow offset for this PopupDialog object.
void	setArrowSize(int width, int height)	Sets the arrow size for this PopupDialog object.
void	setBackColor(Color color)	Sets the background color for this PopupDialog object.
PopupDialog	setCustomComponent(Component customComponent)	Sets the customized content.
PopupDialog	setHasArrow(boolean status)	Sets whether to display an arrow in this PopupDialog object.
PopupDialog	setMode(int mode)	Sets the alignment mode.
PopupDialog	setText(String text)	Sets the text content in the dialog.
void	showOnCertainPosition(int alignment, int x, int y)	Forcibly displays a dialog in a certain position.

从类继承的方法 ohos.agp.window.dialog.BaseDialog

create, destroy, hide, isShowing, obtainComponentViaId, onCreate, onDestroy, onHide, registerDisplayCallback, registerRemoveCallback, remove, searchComponentViaId, setAlignment, setAutoClosable, setCornerRadius, setDialogListener, setDuration, setOffset, setSize, setTransparent, show

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

PopupDialog

public PopupDialog(Context context,
                   Component contentComponent)

A constructor used to create a PopupDialog instance with the width and height of the contentComponent.

参数:

context - Indicates the context to use.

contentComponent - Indicates the component associated with the pop-up dialog box.

从以下版本开始:

4

PopupDialog

public PopupDialog(Context context,
                   Component contentComponent,
                   int width,
                   int height)

A constructor used to create a PopupDialog instance with the specified width and height.

参数:

context - Indicates the context to use.

contentComponent - Indicates the component associated with the pop-up dialog box.

width - Indicates the width of the pop-up dialog box.

height - Indicates the height of the pop-up dialog box.

从以下版本开始:

3

方法详细资料

setHasArrow

public PopupDialog setHasArrow(boolean status)

Sets whether to display an arrow in this PopupDialog object.

参数:

status - Specifies whether an arrow is displayed in this pop-up dialog box. The value true indicates that an arrow is displayed, and {code false} indicates not.

返回:

Returns the PopupDialog object.

从以下版本开始:

4

setArrowSize

public void setArrowSize(int width,
                         int height)

Sets the arrow size for this PopupDialog object.

This method takes effect only when the status parameter of setHasArrow(boolean) is set to true.

参数:

width - Indicates the arrow width to set.

height - Indicates the arrow height to set.

从以下版本开始:

4

setBackColor

public void setBackColor(Color color)

Sets the background color for this PopupDialog object.

参数:

color - Indicates the background color to set.

从以下版本开始:

4

setArrowOffset

public void setArrowOffset(int offset)

Sets the arrow offset for this PopupDialog object.

参数:

offset - Indicates the arrow offset to set.

从以下版本开始:

4

onShow

protected void onShow()

从类复制的说明: BaseDialog

Callback interface used when showing a Dialog instance.

This method takes priority over the BaseDialog.onShowing() method.

覆盖:

onShow 在类中 BaseDialog

onShowing

protected void onShowing()

从类复制的说明: BaseDialog

Called when the pre-layout of a dialog box is complete and the content is being shown in the dialog box.

覆盖:

onShowing 在类中 BaseDialog

setMode

public PopupDialog setMode(int mode)

Sets the alignment mode.

Options include upper-left alignment, lower-left alignment, upper-right alignment, and lower-right alignment.

参数:

mode - Indicates the alignment mode to use, as defined in LayoutAlignment.

返回:

Returns the PopupDialog object for further use. For example, obj.setText(text).show().

setText

public PopupDialog setText(String text)

Sets the text content in the dialog.

This cannot be empty except in user-defined scenarios. setHasArrow(boolean)

参数:

text - Indicates the text content in the dialog.

返回:

Returns the PopupDialog object for further use. For example, obj.setText(text).show().

setCustomComponent

public PopupDialog setCustomComponent(Component customComponent)

Sets the customized content.

The dialog will display the customized content and layout.

参数:

customComponent - Indicates the customized component encapsulated in a ComponentContainer object.

返回:

Returns the PopupDialog object for further use. For example, obj.setText(text).show().

showOnCertainPosition

public void showOnCertainPosition(int alignment,
                                  int x,
                                  int y)

Forcibly displays a dialog in a certain position.

This display position is irrelevant to the component.

参数:

alignment - Indicates the alignment style, such as left alignment, right alignment, and vertical centered.

x - Indicates the X position of the dialog.

y - Indicates the Y position of the dialog.

从以下版本开始:

4