summaryrefslogtreecommitdiffstats
path: root/doc/src/snippets/qtversitdocsample/qtversitdocsample.cpp
diff options
context:
space:
mode:
authorKevin Wu Won <kevin.wu-won@nokia.com>2010-07-08 17:14:36 +1000
committerKevin Wu Won <kevin.wu-won@nokia.com>2010-07-08 17:14:36 +1000
commitdb975e40fd1e17d63158856489bfb9a7c04f7afc (patch)
treeed15784e98142fc1c4b4f15fd3b62fcc858a9353 /doc/src/snippets/qtversitdocsample/qtversitdocsample.cpp
parent7db9dfb3206ab2ef6d5f2d3fefc61d785a162f4e (diff)
Expand docs on Versit main page.
This should make the roles of the importer, exporter, reader, writer and document classes more clear.
Diffstat (limited to 'doc/src/snippets/qtversitdocsample/qtversitdocsample.cpp')
-rw-r--r--doc/src/snippets/qtversitdocsample/qtversitdocsample.cpp19
1 files changed, 12 insertions, 7 deletions
diff --git a/doc/src/snippets/qtversitdocsample/qtversitdocsample.cpp b/doc/src/snippets/qtversitdocsample/qtversitdocsample.cpp
index 257251512d..3a80d740ff 100644
--- a/doc/src/snippets/qtversitdocsample/qtversitdocsample.cpp
+++ b/doc/src/snippets/qtversitdocsample/qtversitdocsample.cpp
@@ -190,38 +190,46 @@ int main(int argc, char *argv[])
void completeExample()
{
- //! [Complete example]
// Create the input vCard
+ //! [Complete example - create]
QBuffer input;
input.open(QBuffer::ReadWrite);
QByteArray inputVCard =
"BEGIN:VCARD\r\nVERSION:2.1\r\nFN:John Citizen\r\nN:Citizen;John;Q;;\r\nEND:VCARD\r\n";
input.write(inputVCard);
input.seek(0);
+ //! [Complete example - create]
// Parse the input into QVersitDocuments
+ //! [Complete example - read]
// Note: we could also use the more convenient QVersitReader(QByteArray) constructor.
QVersitReader reader;
reader.setDevice(&input);
reader.startReading(); // Remember to check the return value
reader.waitForFinished();
+ QList<QVersitDocument> inputDocuments = reader.results();
+ //! [Complete example - read]
// Convert the QVersitDocuments to QContacts
- QList<QVersitDocument> inputDocuments = reader.results();
+ //! [Complete example - import]
QVersitContactImporter importer;
if (!importer.importDocuments(inputDocuments))
return;
QList<QContact> contacts = importer.contacts();
// Note that the QContacts are not saved yet.
// Use QContactManager::saveContacts() for saving if necessary
+ //! [Complete example - import]
// Export the QContacts back to QVersitDocuments
+ //! [Complete example - export]
QVersitContactExporter exporter;
if (!exporter.exportContacts(contacts, QVersitDocument::VCard30Type))
return;
QList<QVersitDocument> outputDocuments = exporter.documents();
+ //! [Complete example - export]
// Encode the QVersitDocument back to a vCard
+ //! [Complete example - write]
// Note: we could also use the more convenient QVersitWriter(QByteArray*) constructor.
QBuffer output;
output.open(QBuffer::ReadWrite);
@@ -229,11 +237,8 @@ void completeExample()
writer.setDevice(&output);
writer.startWriting(outputDocuments); // Remember to check the return value
writer.waitForFinished();
-
- // Read the vCard back to a QByteArray
- output.seek(0);
- QByteArray outputVCard(output.readAll());
- //! [Complete example]
+ // output.buffer() now contains a vCard
+ //! [Complete example - write]
}
void exportExample()