公開日: 2016年11月
対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2013、Dynamics CRM 2015、Dynamics CRM 2016
このトピックでは、ユーザー インターフェイス (UI) コントロールを特定するために使用できる 2 つの方法について説明します。
このトピックの内容
UI ツリーベースの ID
オフセット ベースの特定
UI ツリーベースの ID
この方法では、コントロール ツリー構造全部を取得します。 また、すべてのコントロール プロパティを使用して、最後のコントロールまで詳しく調べます。
サンプルのバインディング フォーマットを以下に示します。
<UIElement Name="UISystemandSecurityHyperlink">
<UIObject MatchCount="1">
<AndCondition>
<PropertyCondition Name="Name">CPCategoryPanel</PropertyCondition>
<PropertyCondition Name="ControlType">Pane</PropertyCondition>
</AndCondition>
<UIObject>
<AndCondition>
<PropertyCondition Name="Name">System and Security</PropertyCondition>
<PropertyCondition Name="ControlType">Hyperlink</PropertyCondition>
</AndCondition>
</UIObject>
</UIObject>
<UIElement>
タグについて以下の通り説明します。
<UIElement> – これは Name 属性を持つルート ノードです。
Name – DDA で使用されるフレンドリ名を取得します。
StartFromDesktop – 検索をデスクトップまたは現在の親から開始するか指定します。
ParentUIElement – 親コントロールとして使用する必要のある UIElement を指定します。 ボタンの場合は、"ウィンドウ" を ParentUIElement として指定する必要があります。 これは、バインディングを手動で作成するときに便利です。
MatchCount – マッチ数を指定します。 複数のコントロールのプロパティが同じ場合、コントロールはこのインデックスに基づいて特定されます。
<UIObject> – このノードは、コントロールを特定するためにツリー構造一式を取得します。
<PropertyCondition Name="Name">CPCategoryPanel</PropertyCondition> – コントロール検索の対象となるプロパティの状態を取得します。 これは AndCondition/OrCondition/NotCondition でグループ化されます。PropertyCondition が 1 つのみの場合、グループ分けなしで、ルート ノードに表示されます。Nameは、コントロール プロパティの代表です。
AndCondition、OrCondition、および NotCondition – プロパティの状態のグループ化の条件。
<AndCondition Id="SearchCondition"> – コントロールを特定する、プロパティの状態を取得します。Id は条件リスト ID を表します。 グループ化を後で指定するとき、複数の AndCondition を使用できます。
<OrCondition Id="SearchCondition"> – コントロールを特定する、プロパティの状態を取得します。Id は条件リスト ID を表します。 グループ化を後で指定するとき、複数の OrCondition を使用できます。
<NotCondition Id="SearchCondition"> – コントロールを特定する、プロパティの状態を取得します。Id は条件リスト ID を表します。 グループ化を後で指定するとき、複数の NotCondition を使用できます。
AndCondition、OrCondition、および NotCondition – 入れ子にできますが、正しくグループ化する必要があります。 最上位の XML バインディングの状態は 1 つだけにする必要があり、内部的にグループ化することができます。
オフセット ベースの特定
この方法は、操作が簡単で、バインディングも作成します。
注意
この方法は、コントロールを識別するために UI ツリー内の位置番号を使用するので、コントロール ツリーの場所が変化する場合は使用できません。 UI ツリーの場所が動的に変更される場合は、この方法は使用できません。
MatchCount 属性はオフセット レベルとして使用されます。 必要に応じて、条件を指定する必要があります。
サンプルのバインディング フォーマットを以下に示します。
<UIElement name="textBoxTabPage1">
<UIObject MatchCount="2">
<UIObject MatchCount="1">
<UIObject MatchCount="2">
</UIObject>
</UIObject>
</UIObject>
</UIElement>
関連項目
Unified Service Desk 2.0
© 2017 Microsoft. All rights reserved. 著作権