QPlaceAttribute Class

詳細な説明

QPlaceAttribute インスタンスは、QPlace クラスを通じて通常は公開されない、場所に関する追加情報を格納します。QPlaceAttribute は、その属性を説明するローカライズされたラベルと、属性の値を表すリッチテキスト文字列をカプセル化しています。一般的に、これらはいずれもそのままエンドユーザーに表示されることを意図しています。

プラグインによっては、属性をまったくサポートしていないものもあれば、特定のセットのみをサポートするもの、時間の経過とともに動的に変化する属性セットをサポートするもの、さらにはクライアントアプリケーションによる任意の属性定義を許可するものもあります。また、属性は場所ごとに異なる場合もあります。例えば、ある場所には営業時間がある一方で、別の場所にはそれがないといった具合です。 詳細については、プラグインのリファレンスを参照してください。

属性の種類

QPlaceAttribute クラスは、標準的な属性タイプを特徴づけるいくつかの定数文字列を定義しています。

• QPlaceAttribute::OpeningHours
• QPlaceAttribute::Payment
• QPlaceAttribute::Provider

x_id_<provider> という形式の属性タイプ（例: x_id_here）のクラスがあります。このクラスの属性は、指定されたプロバイダの観点から見た、その場所の代替識別子のセットです。

上記のタイプは、QPlace 内の属性へのアクセスおよび変更に、以下を通じて使用されます。

• QPlace::extendedAttribute()
• QPlace::setExtendedAttribute()
• QPlace::removeExtendedAttribute()
• QPlace::removeExtendedAttribute()

属性型は文字列型であるため、プロバイダーは必要に応じて新しい属性を導入することができます。競合を避けるため、カスタム属性型には常に修飾子をプレフィックスとして付ける必要があります。

ユーザーが読み取れる属性と読み取れない属性

一部の属性は、エンドユーザーによる閲覧を意図していない場合があります。そのような属性のlabelフィールドは、この事実を示すために空になっています。