372 } |
372 } |
373 |
373 |
374 /*! Returns a list of details with the given \a definitionName |
374 /*! Returns a list of details with the given \a definitionName |
375 The definitionName string can be determined by the DefinitionName attribute |
375 The definitionName string can be determined by the DefinitionName attribute |
376 of defined objects (e.g. QContactPhoneNumber::DefinitionName) or by |
376 of defined objects (e.g. QContactPhoneNumber::DefinitionName) or by |
377 requesting a list of all the definitions synchronously with |
377 requesting a list of all the definition names using |
378 \l {QContactManager::detailDefinitions()}{detailDefinitions()} or |
378 \l {QContactManager::detailDefinitions()}{detailDefinitions()} or the |
379 asynchronously with a |
379 asynchronous \l |
380 \l {QContactDetailDefinitionFetchRequest}{detail definition fetch request}, |
380 {QContactDetailDefinitionFetchRequest::definitionNames()}{definitionNames()}.*/ |
381 and then inspecting the |
|
382 \l{QContactDetailDefinition::name()}{name()} of each |
|
383 definition. If \a definitionName is empty, all details of any definition |
|
384 will be returned. |
|
385 */ |
|
386 QList<QContactDetail> QContact::details(const QString& definitionName) const |
381 QList<QContactDetail> QContact::details(const QString& definitionName) const |
387 { |
382 { |
388 // build the sub-list of matching details. |
383 // build the sub-list of matching details. |
389 QList<QContactDetail> sublist; |
384 QList<QContactDetail> sublist; |
390 |
385 |
405 |
400 |
406 /*! |
401 /*! |
407 Returns a list of details of the given \a definitionName, with fields named \a fieldName and with value \a value. |
402 Returns a list of details of the given \a definitionName, with fields named \a fieldName and with value \a value. |
408 The definitionName string can be determined by the DefinitionName attribute |
403 The definitionName string can be determined by the DefinitionName attribute |
409 of defined objects (e.g. QContactPhoneNumber::DefinitionName) or by |
404 of defined objects (e.g. QContactPhoneNumber::DefinitionName) or by |
410 requesting a list of all the definitions synchronously with |
405 requesting a list of all the definition names using |
411 \l {QContactManager::detailDefinitions()}{detailDefinitions()} or |
406 \l {QContactManager::detailDefinitions()}{detailDefinitions()} or the |
412 asynchronously with a |
407 asynchronous \l |
413 \l {QContactDetailDefinitionFetchRequest}{detail definition fetch request}, |
408 {QContactDetailDefinitionFetchRequest::definitionNames()}{definitionNames()}.*/ |
414 and then inspecting the |
|
415 \l{QContactDetailDefinition::name()}{name()} of each |
|
416 definition. If \a definitionName is empty, all details of any definition |
|
417 will be returned. |
|
418 */ |
|
419 QList<QContactDetail> QContact::details(const QString& definitionName, const QString& fieldName, const QString& value) const |
409 QList<QContactDetail> QContact::details(const QString& definitionName, const QString& fieldName, const QString& value) const |
420 { |
410 { |
421 // build the sub-list of matching details. |
411 // build the sub-list of matching details. |
422 QList<QContactDetail> sublist; |
412 QList<QContactDetail> sublist; |
423 |
413 |