Класс QGeoAddress
Класс QGeoAddress представляет адрес QGeoLocation. Подробнее...
| Заголовок: | #include <QGeoAddress> |
| CMake: | find_package(Qt6 COMPONENTS Positioning REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| С момента: | Qt 5.2 |
Открытые функции
| QGeoAddress(QGeoAddress &&other) | |
| QGeoAddress(const QGeoAddress &other) | |
| QGeoAddress() | |
| QGeoAddress & | operator=(QGeoAddress &other) |
| QGeoAddress & | operator=(const QGeoAddress &address) |
| ~QGeoAddress() | |
| QString | city() const |
| void | clear() |
| QString | country() const |
| QString | countryCode() const |
| QString | county() const |
| QString | district() const |
| bool | isEmpty() const |
| bool | isTextGenerated() const |
| QString | postalCode() const |
| void | setCity(const QString &city) |
| void | setCountry(const QString &country) |
| void | setCountryCode(const QString &countryCode) |
| void | setCounty(const QString &county) |
| void | setDistrict(const QString &district) |
| void | setPostalCode(const QString &postalCode) |
| void | setState(const QString &state) |
| void | setStreet(const QString &street) |
| void | setStreetNumber(const QString &streetNumber) |
| void | setText(const QString &text) |
| QString | state() const |
| QString | street() const |
| QString | streetNumber() const |
| QString | text() const |
Связанные нечлены
| size_t | qHash(const QGeoAddress &address, size_t seed = 0) |
| bool | operator!=(const QGeoAddress &lhs, const QGeoAddress &rhs) |
| bool | operator==(const QGeoAddress &lhs, const QGeoAddress &rhs) |
Подробное описание
Атрибуты адреса нормализованы для имен элементов США и могут быть сопоставлены с местными уровнями элементов (например, штат соответствует «Bundesland» в Германии).
Адрес содержит text() для отображения и дополнительные свойства для доступа к компонентам адреса:
- QGeoAddress::country()
- QGeoAddress::countryCode()
- QGeoAddress::state()
- QGeoAddress::city()
- QGeoAddress::district()
- QGeoAddress::street()
- QGeoAddress::postalCode()
Документация функций-членов
[since 6.2] QGeoAddress::QGeoAddress(QGeoAddress &&other)
Конструирует объект геоадреса, перемещая его из other.
Примечание: Перемещенный объект QGeoAddress может быть только уничтожен или присвоен. Эффект вызова других функций, кроме деструктора или одного из операторов присваивания, не определен.
Эта функция была введена в Qt 6.2.
QGeoAddress::QGeoAddress(const QGeoAddress &other)
Создает копию other.
QGeoAddress::QGeoAddress()
Конструктор по умолчанию.
[default, since 6.2] QGeoAddress &QGeoAddress::operator=(QGeoAddress &other)
Перемещает присваивает other этому адресу и возвращает ссылку на этот адрес.
Примечание: Перемещенный объект QGeoAddress может быть только уничтожен или присвоен. Эффект вызова других функций, кроме деструктора или одного из операторов присваивания, не определен.
Эта функция была введена в Qt 6.2.
QGeoAddress &QGeoAddress::operator=(const QGeoAddress &address)
Присваивает заданный address этому адресу и возвращает ссылку на этот адрес.
QGeoAddress::~QGeoAddress()
Уничтожает этот адрес.
QString QGeoAddress::city() const
Возвращает город.
См. также setCity().
void QGeoAddress::clear()
Очищает все поля данных адреса.
QString QGeoAddress::country() const
Возвращает название страны.
См. также setCountry().
QString QGeoAddress::countryCode() const
Возвращает код страны в соответствии с ISO 3166-1 alpha-3.
См. также setCountryCode().
QString QGeoAddress::county() const
Возвращает округ. Округ считается второй подподразделением ниже страны.
См. также setCounty().
QString QGeoAddress::district() const
Возвращает район. Район считается подподразделением ниже города.
См. также setDistrict().
bool QGeoAddress::isEmpty() const
Возвращает значение true, если этот адрес пустой. Адрес считается пустым, если все его поля пустые.
bool QGeoAddress::isTextGenerated() const
Возвращает true, если QGeoAddress::text() автоматически сгенерирован из элементов адреса, в противном случае возвращает false, если text() был явно задан.
QString QGeoAddress::postalCode() const
Возвращает почтовый индекс.
См. также setPostalCode().
void QGeoAddress::setCity(const QString &city)
Устанавливает город.
См. также city().
void QGeoAddress::setCountry(const QString &country)
Устанавливает имя страны.
См. также country().
void QGeoAddress::setCountryCode(const QString &countryCode)
Устанавливает countryCode в соответствии с ISO 3166-1 alpha-3
См. также countryCode().
void QGeoAddress::setCounty(const QString &county)
Устанавливает район.
См. также county().
void QGeoAddress::setDistrict(const QString &district)
Устанавливает район.
См. также district().
void QGeoAddress::setPostalCode(const QString &postalCode)
Устанавливает почтовый индекс.
См. также postalCode().
void QGeoAddress::setState(const QString &state)
Устанавливает штат.
См. также state().
void QGeoAddress::setStreet(const QString &street)
Устанавливает название улицы на street.
Примечание: До Qt6 это также могло содержать такие вещи, как номер квартиры, название здания или что-то еще, что могло бы использоваться для различения одного адреса от другого. Используйте setStreetNumber(), чтобы задать эти данные сейчас.
См. также street() и setStreetNumber().
void QGeoAddress::setStreetNumber(const QString &streetNumber)
Устанавливает номер улицы на streetNumber.
Это также может содержать такие вещи, как номер квартиры, название здания или что-то еще, что может использоваться для различения одного адреса от другого.
Примечание: До Qt6 эта информация задавалась методом setStreet().
Эта функция была добавлена в Qt 6.2.
См. также streetNumber() и setStreet().
void QGeoAddress::setText(const QString &text)
Если text не пустая, явно присваивает text как строку, которая должна возвращаться text(). isTextGenerated() вернёт false.
Если text пустая, указывает, что text() должен быть автоматически сгенерирован из элементов адреса. isTextGenerated() вернёт true.
См. также text().
QString QGeoAddress::state() const
Возвращает штат. Штат считается первой административной единицей ниже страны.
См. также setState().
QString QGeoAddress::street() const
Возвращает название улицы.
Примечание: До Qt6 это также могло содержать такие вещи, как номер квартиры, название здания или что-то ещё, что могло использоваться для различения одного адреса от другого. Используйте streetNumber(), чтобы получить эти данные сейчас.
См. также setStreet() и streetNumber().
QString QGeoAddress::streetNumber() const
Возвращает номер улицы.
Примечание: До Qt6 эта информация возвращалась методом street().
Эта функция была добавлена в Qt 6.2.
См. также setStreetNumber() и street().
QString QGeoAddress::text() const
Возвращает адрес как строку с форматированием. Это рекомендуемая строка для отображения адреса пользователю. Обычно она имеет формат адреса, как на конверте, но это не всегда так.
Текст адреса либо автоматически генерируется, либо явно задаётся. Это можно определить, проверив isTextGenerated.
Если в setText() передана пустая строка, то isTextGenerated() будет установлено в true и text() вернёт строку, отформатированную локально в соответствии с countryCode() и на основе элементов адреса, таких как улица, город и т. д. Поскольку строка текста генерируется из элементов адреса, последовательность вызовов, таких как text(), setStreet(), text() может возвращать разные строки при каждом вызове text().
Если в setText() передана непустая строка, то isTextGenerated() будет установлено в false и text() всегда вернёт явно заданную строку. Вызовы для изменения других элементов, таких как setStreet(), setCity() и т. д., не повлияют на результирующую строку из text().
См. также setText().
Связанные нечленные функции
size_t qHash(const QGeoAddress &address, size_t seed = 0)
Возвращает хеш-значение для address, используя seed для расчёта.
bool operator!=(const QGeoAddress &lhs, const QGeoAddress &rhs)
Возвращает true если адрес lhs не равен rhs, в противном случае возвращает false.
bool operator==(const QGeoAddress &lhs, const QGeoAddress &rhs)
Возвращает true если адрес lhs равен rhs, в противном случае возвращает false.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qgeoaddress.html