QGeoRectangle Class
QGeoRectangle クラスは、矩形の地理領域を定義します。詳細...
| Header: | #include <QGeoRectangle> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Inherits: | QGeoShape |
プロパティ
|
パブリック関数
| QGeoRectangle() | |
| QGeoRectangle(const QGeoShape &other) | |
| QGeoRectangle(const QList<QGeoCoordinate> &coordinates) | |
| QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight) | |
| QGeoRectangle(const QGeoCoordinate ¢er, double degreesWidth, double degreesHeight) | |
| QGeoRectangle(const QGeoRectangle &other) | |
| ~QGeoRectangle() | |
| QGeoCoordinate | bottomLeft() const |
| QGeoCoordinate | bottomRight() const |
| QGeoCoordinate | center() const |
| bool | contains(const QGeoRectangle &rectangle) const |
| void | extendRectangle(const QGeoCoordinate &coordinate) |
| double | height() const |
| bool | intersects(const QGeoRectangle &rectangle) const |
| void | setBottomLeft(const QGeoCoordinate &bottomLeft) |
| void | setBottomRight(const QGeoCoordinate &bottomRight) |
| void | setCenter(const QGeoCoordinate ¢er) |
| void | setHeight(double degreesHeight) |
| void | setTopLeft(const QGeoCoordinate &topLeft) |
| void | setTopRight(const QGeoCoordinate &topRight) |
| void | setWidth(double degreesWidth) |
| QString | toString() const |
| QGeoCoordinate | topLeft() const |
| QGeoCoordinate | topRight() const |
| void | translate(double degreesLatitude, double degreesLongitude) |
| QGeoRectangle | translated(double degreesLatitude, double degreesLongitude) const |
| QGeoRectangle | united(const QGeoRectangle &rectangle) const |
| double | width() const |
| QGeoRectangle & | operator=(const QGeoRectangle &other) |
| QGeoRectangle | operator|(const QGeoRectangle &rectangle) const |
| QGeoRectangle & | operator|=(const QGeoRectangle &rectangle) |
詳細説明
矩形は、矩形の左上座標を指定するQGeoCoordinate と、矩形の右下座標を指定するQGeoCoordinate で定義されます。
ジオ矩形は、左上座標または右下座標が無効な場合、あるいは左上座標が右下座標より南にある場合、無効であるとみなされます。
ジオ矩形は決して極を横切ることはできません。
い く つかの メ ソ ッ ド は、 ジ オ矩形が中心座標 と 、 ジ オ矩形の幅 （度単位） と 、 ジ オ矩形の高 さ （度単位） と で定義 さ れてい るかの よ う に動作 し ます。
ジオ矩形の高さや中心が、極の 1 つを横切るように調整された場合、ジオ矩形が極に接するが横切らないように、また中心座標がジオ矩形の中心にあるように、高さが修正されます。
このクラスは Qt 5.5 以降のQ_GADGET です。C++やQMLから直接使用することができます。
プロパティの説明
bottomLeft : QGeoCoordinate
このプロパティは、このジオ矩形の左下座標を保持します。
このプロパティはQt 5.5で導入されましたが、関連するアクセサ関数はこのクラスの最初のバージョンから存在しています。
アクセス関数
| QGeoCoordinate | bottomLeft() const |
| void | setBottomLeft(const QGeoCoordinate &bottomLeft) |
bottomRight : QGeoCoordinate
このプロパティは、このジオ矩形の右下座標を保持します。
このプロパティはQt 5.5で導入されましたが、関連するアクセサ関数はこのクラスの最初のバージョンから存在しています。
アクセス関数：
| QGeoCoordinate | bottomRight() const |
| void | setBottomRight(const QGeoCoordinate &bottomRight) |
center : QGeoCoordinate
このプロパティは、このジオ矩形の中心を保持します。
このプロパティは Qt 5.5 で導入されましたが、関連するアクセサ関数はこのクラスの最初のバージョンから存在しています。
アクセス関数：
QGeoShape::centerも参照してください 。
height : double
このプロパティは、このジオ矩形の高さを度単位で保持する。
このジオ矩形が無効な場合、プロパティ値は未定義です。
新しい高さが 0.0 より小さい場合、またはこのジオ矩形が無効な場合、このプロパティは変更されません。中心、幅、高さに基づいて無効なジオ矩形の値を設定するには、まずsetCenter() を使用してジオ矩形を有効にする必要があります。
高さの変更によってジオ矩形がポールを横切ることになる場合は、ジオ矩形がポールに触れるだけになるように高さが調整される。
この変更は、中心座標がまだジオ矩形の中心にあるように行われるため、予想よりも小さな高さのジオ矩形になる可能性があります。
180.0 は、新しい高さが 180 以上の場合にのみ使用される高さです。
このプロパティは Qt 5.5 で導入されましたが、関連するアクセサ関数はこのクラスの最初のバージョンから存在しています。
アクセス関数：
topLeft : QGeoCoordinate
このプロパティは、このジオ矩形の左上座標を保持します。
このプロパティは Qt 5.5 で導入されましたが、関連するアクセサ関数はこのクラスの最初のバージョンから存在しています。
アクセス関数：
| QGeoCoordinate | topLeft() const |
| void | setTopLeft(const QGeoCoordinate &topLeft) |
topRight : QGeoCoordinate
このプロパティは、このジオ矩形の右上座標を保持します。
このプロパティはQt 5.5で導入されましたが、関連するアクセサ関数はこのクラスの最初のバージョンから存在しています。
アクセス関数：
| QGeoCoordinate | topRight() const |
| void | setTopRight(const QGeoCoordinate &topRight) |
width : double
このプロパティは、このジオ矩形の幅を度単位で保持する。
このジオ矩形が無効な場合、プロパティ値は未定義である。
新しい幅が 0.0 より小さい場合、またはこのジオ矩形が無効な場合、この関数は何もしません。中心、幅、高さに基づいて無効なジオ矩形の値を設定するには、まずsetCenter() を使用してジオ矩形を有効にする必要があります。
360.0 は、新しい幅が 360 以上の場合にのみ使用される幅である。このような場合、ジオ矩形の左端の経度は -180.0 度に設定され、ジオ矩形の右端の経度は 180.0 度に設定されます。
このプロパティは Qt 5.5 で導入されましたが、関連するアクセサ関数はこのクラスの最初のバージョンから存在しています。
アクセス関数
メンバ関数ドキュメント
QGeoRectangle::QGeoRectangle()
新しい、無効なジオ矩形を構築する。
QGeoRectangle::QGeoRectangle(const QGeoShape &other)
other の内容からジオ矩形を構築する。
QGeoRectangle::QGeoRectangle(const QList<QGeoCoordinate> &coordinates)
coordinates のすべてを含む、最小サイズの新しいジオ矩形を構築する。
QGeoRectangle::QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight)
左上座標topLeft と 右下座標bottomRight を持つ新規ジオ矩形を構築。
QGeoRectangle::QGeoRectangle(const QGeoCoordinate ¢er, double degreesWidth, double degreesHeight)
center を中心とし、幅（°）がdegreesWidth で、高さ（°）がdegreesHeight の新しいジオ矩形を構築する。
degreesHeight でジオ矩形が極の 1 つを超え る よ う にな る と き は、 ジ オ矩形の高 さ は切 り 捨て ら れ、 ジ オ矩形は極ま でしか拡が ら な く な り ます。ジオ矩形の中心は変更されず、中心点が切り捨てられたジオ矩形の中心に来るように高さが調整されます。
QGeoRectangle::QGeoRectangle(const QGeoRectangle &other)
other の内容からジオ矩形を構築します。
[noexcept] QGeoRectangle::~QGeoRectangle()
このジオ矩形を破棄します。
QGeoCoordinate QGeoRectangle::bottomLeft() const
このジオ矩形の左下座標を返す。
注： プロパティ bottomLeft に対するゲッター関数。
setBottomLeft()も参照してください 。
QGeoCoordinate QGeoRectangle::bottomRight() const
このジオ矩形の右下座標を返します。
メモ： bottomRight プロパティのゲッター関数。
setBottomRight() も参照 。
QGeoCoordinate QGeoRectangle::center() const
このジオ矩形の中心を返します。QGeoShape::center() と同等。
注： プロパティ center のゲッター関数。
setCenter()も参照 。
bool QGeoRectangle::contains(const QGeoRectangle &rectangle) const
ジオ矩形rectangle がこのジオ矩形内に含まれるかどうかを返します。
[invokable] void QGeoRectangle::extendRectangle(const QGeoCoordinate &coordinate)
ジオ矩形を拡張して、座標もカバーする。coordinate
注意: この関数は、メタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
double QGeoRectangle::height() const
このジオ矩形の高さを度単位で返します。
このジオ矩形が無効な場合、戻り値は未定義です。
注： height プロパティのゲッター関数。
setHeight()も参照 。
[invokable] bool QGeoRectangle::intersects(const QGeoRectangle &rectangle) const
ジオ矩形rectangle がこのジオ矩形と交差しているかどうかを返します。
両方のジオ矩形の上辺または下辺がいずれかの極にある場合、ジオ矩形は交差しているとみなされます。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
void QGeoRectangle::setBottomLeft(const QGeoCoordinate &bottomLeft)
このジオ矩形の左下座標をbottomLeft に設定します。
注： プロパティbottomLeft のセッター関数です。
bottomLeft()も参照してください 。
void QGeoRectangle::setBottomRight(const QGeoCoordinate &bottomRight)
このジオ矩形の右下座標をbottomRight に設定します。
注: プロパティbottomRight のセッター関数。
bottomRight()も参照 。
void QGeoRectangle::setCenter(const QGeoCoordinate ¢er)
このジオ矩形の中心をcenter に設定します。
こ れに よ っ て ジ オ矩形が極を横切 る よ う にな る と き は、 ジ オ矩形の高 さ は切 り 捨て ら れ、 ジ オ矩形は極までしか拡が ら な く な り ます。ジオ矩形の中心は変更されず、中心点が切り捨てられたジオ矩形の中心に来るように高さが調整されます。
注： プロパティcenter に対するセッター関数。
center()も参照 。
void QGeoRectangle::setHeight(double degreesHeight)
このジオ矩形の高さを度単位でdegreesHeight に設定します。
注： プロパティheight のセッター関数。
height()も参照 。
void QGeoRectangle::setTopLeft(const QGeoCoordinate &topLeft)
このジオ矩形の左上座標をtopLeft に設定します。
注: プロパティtopLeft に対するセッター関数。
topLeft()も参照 。
void QGeoRectangle::setTopRight(const QGeoCoordinate &topRight)
このジオ矩形の右上座標をtopRight に設定します。
注: プロパティtopRight のセッター関数です。
topRight()も参照 。
void QGeoRectangle::setWidth(double degreesWidth)
このジオ矩形の幅を度単位でdegreesWidth に設定します。
注: プロパティwidth のセッター関数。
width()も参照 。
[invokable] QString QGeoRectangle::toString() const
ジオ矩形プロパティを文字列として返します。
注： この関数はメタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
QGeoCoordinate QGeoRectangle::topLeft() const
このジオ矩形の左上座標を返します。
注： プロパティ topLeft のゲッター関数。
setTopLeft()も参照してください 。
QGeoCoordinate QGeoRectangle::topRight() const
このジオ矩形の右上座標を返します。
メモ： property topRight のゲッター関数。
setTopRight() も参照 。
[invokable] void QGeoRectangle::translate(double degreesLatitude, double degreesLongitude)
このジオ矩形を、degreesLatitude 北方向およびdegreesLongitude 東方向に変換します。
degreesLatitude とdegreesLongitude の負の値は、 それぞれ南向きと西向きの平行移動に対応します。
変換によってジオ矩形が極を横切ることになる場合、ジオ矩形は、ジオ矩形の上端または下端が極に触れるまで変換されますが、それ以上は変換されません。
注意： この関数はメタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] QGeoRectangle QGeoRectangle::translated(double degreesLatitude, double degreesLongitude) const
このジオ矩形のコピーを、degreesLatitude によって北に、degreesLongitude によって東に変換して返します。
degreesLatitude とdegreesLongitude の負の値は、それぞれ南向きと西向きの変換に対応します。
注意： この関数はメタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
translate()も参照してください 。
[invokable] QGeoRectangle QGeoRectangle::united(const QGeoRectangle &rectangle) const
このジオ矩形とrectangle の両方を含む最小のジオ矩形を返します。
2つのジオ矩形の中心がちょうど180.0度離れている場合、幅は360.0度に設定され、左端の経度は-180.0度、右端の経度は180.0度に設定されます。これは、結果がオペランドの順序に依存しないようにするためである。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
double QGeoRectangle::width() const
このジオ矩形の幅を度単位で返します。
このジオ矩形が無効な場合、戻り値は未定義です。
注： プロパティ width のゲッター関数。
setWidth()も参照 。
QGeoRectangle &QGeoRectangle::operator=(const QGeoRectangle &other)
このジオ矩形にother を代入し、このジオ矩形への参照を返します。
QGeoRectangle QGeoRectangle::operator|(const QGeoRectangle &rectangle) const
このジオ矩形とrectangle の両方を含む最小のジオ矩形を返します。
2つのジオ矩形の中心がちょうど 180.0 度離れている場合、幅は 360.0 度に設定され、左端の経度は -180.0 度に、右端の経度は 180.0 度に設定されます。これは、結果がオペランドの順序に依存しないようにするためです。
QGeoRectangle &QGeoRectangle::operator|=(const QGeoRectangle &rectangle)
このジオ矩形とrectangle の両方を含む最小のジオ矩形を返します。
2つのジオ矩形の中心がちょうど 180.0度離れている場合、幅は 360.0度に設定され、左端の経度は -180.0度、右端の経度は 180.0度に設定されます。これは、結果がオペランドの順序に依存しないようにするためです。
本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
