def promptText(parent, message, title = None, text="", rx=None, help=None):
"""
Prompts for a text. Returns None on cancel, otherwise the input string.
rx = if given, regexp string that the input must validate against
help = if given, the docbook id in the help menu handbook.
"""
d = KDialog(parent)
buttons = KDialog.Ok | KDialog.Cancel
if help:
buttons |= KDialog.Help
d.setHelp(help)
d.setButtons(KDialog.ButtonCode(buttons))
if title:
d.setCaption(title)
v = KVBox()
v.setSpacing(4)
d.setMainWidget(v)
QLabel(message, v)
edit = KLineEdit(v)
if rx:
edit.setValidator(QRegExpValidator(QRegExp(rx), edit))
edit.setText(text)
d.show()
edit.setFocus()
if d.exec_():
return edit.text()
