QPlaceAttribute Class

詳細な説明

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

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

属性タイプ

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

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

例えば、x_id_<provider> のような形式の属性タイプのクラスがあります。この属性のクラスは、指定されたプロバイダーから見た場所の代替識別子のセットです。

上記の型は、QPlace ：

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

属性型は文字列型なので、プロバイダは必要に応じて新しい属性を導入することができます。独自の属性型は、衝突を避けるために、常に修飾子を先頭に付けるべきです。

ユーザー可読属性と非ユーザー可読属性

属性の中には、エンドユーザーが読むことを意図していないものもあります。そのような属性のラベルフィールドは、この事実を示すために空です。