WxWidgets wxGenericProgressDialog
跳到导航
跳到搜索
Update()
更新对话框,将进度条设置为新的值,如果指定了新的消息,则更新消息。
除非按下了“取消”按钮,否则返回 true。
如果返回的是假值,应用程序可以立即销毁对话框,也可以要求用户确认,如果不确认,则可以使用 Resume() 函数恢复对话框。
如果“value”是对话框的最大值,该函数的行为取决于该对话框在创建时是否使用了wxPD_AUTO_HIDE标志。如果使用了,则对话框将被隐藏,并且函数立即返回。如果没有使用,则对话框将成为一个模态对话框,等待用户关闭它。这意味着该函数只有在用户关闭对话框后才会返回。
注意,如果新消息比当前显示的消息更长,对话框将自动变宽以适应它。然而,如果新消息比之前的消息更短,则对话框不会收缩,以免在消息频繁更改时频繁调整大小。要这样做并使对话框适合其当前内容,您可以显式地调用Fit()方法。然而,该类的原生MSW实现确实会使对话框变短,如果新文本的行数比旧文本少,因此建议保持文本行数不变以避免对话框大小的突然变化。您可能还希望在创建对话框时将初始消息设置为足够的宽度,以避免以后需要调整对话框的大小,例如通过向其添加一个很长的不可拆分空格字符串(wxString(L'\u00a0', 100))。
参数
- 进度条的新值。它应该小于或等于在构造函数中指定的最大值。
- 新消息:如果进度对话框文本为空(这是默认值),则消息不会被更改。
- 跳过:如果自上一次调用 Update() 以来按下了“跳过”按钮,则该值将被设置为 true。