KMLレイヤは、KML(Keyhole マークアップ言語)または KMZ(圧縮した KML)ファイルをマップ上にレンダリングします。ファイル名は、レイヤ上の KmlFileNameプロパティによって指定されます。このファイルは、URL やローカルディスクファイルからロードしたり、レポートに埋め込むことができます。このファイルが埋め込まれていなくて(EmbedKmlFileが False)、ディレクトリが指定されていない場合、このファイルはレポート定義を格納するディレクトリからロードされます。
- KML 項目式:KMLレイヤがレンダリングされると、KML ファイル内にある項目が順に処理されます。各項目がロードされると、レイヤ上で指定されたいくつかの式が評価され、処理を制御できます。たとえば、さまざまな条件に基づいて特定の項目だけをロードするか、項目の視覚属性だけを変更します。さらに、KML レイヤの RecordSourceが 指定された場合、項目式を評価する前に各 KML 項目のデータをフィルタできます。以下に、KML 項目式の評価に関係するプロパティを詳しく説明します。これらのすべての式で、特別な変数 kmlItemNameを使用でき、現在処理されている KML 項目名を参照することに注意してください。
- ItemFilterExpr: RecordSourceが KML レイヤ上に指定された場合(のみ)、他の式を評価する前に、このフィルタが取得されたデータに適用されます。たとえば、レイヤのレコードソースが「国」フィールドを含み、KML ファイルが国の項目を含む場合、次のフィルタは
kmlItemName=Country
KML項目ごとに、他の項目式が現在の項目の国に対応するデータで評価されるようにします。
- ItemTrackExpr: 指定された場合、自動的にマップを中央揃え/ズームするために項目が使用されるかどうかを決定します。空のままにすると、true と見なされます。
- ItemVisibleExpr: 指定された場合、項目の表示/非表示を決定します。空のままにすると、true と見なされます。
- ItemStyleExpr: iこの式が(現在の、またはレポート内の他の任意のマップの) KmlItemStylesコレクション内の有効なスタイル名に評価された場合、このスタイルが項目に適用されます。これは、たとえば、州の注文合計などのデータ値に応じて、異なる州を異なる色で塗りつぶす場合に使用できます。
- ItemStyle.ItemNameExpr: KML項目スタイルはそれ自身、1つの計算されたプロパティ、つまり項目名を含みます。これにより、マップ上にレンダリングされた名前を隠したり、それをレポートデータ(注文合計など)に置き換えることができます。