Dialog: Add missing docs

Also fixed a qWarning and updated example import statement.

Change-Id: I873b52e297bbefe66c6c131573804eee98c40a2f
Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>