バージョン

コントロール プロパティへのアクセス

トピックの概要

目的

このトピックは、Infragistics コントロールのプロパティおよびサブプロパティにアクセスするメソッドについての参照情報を提供します。

プロパティ アクセスの概要

プロパティ アクセスの要旨表

以下の表は、プロパティ アクセス タスクを実装する Test Automation メソッドにマップします。

目的 このメソッドを使用:

コントロールの (サブ) プロパティの値を取得します。

コントロールのサブ項目の (サブ) プロパティの値を取得します。

コントロールの表示可能なプロパティのリストを取得します。

コントロールのサブ項目の表示可能なプロパティのリストを取得します。

コントロールの (サブ) プロパティの値を設定します。

コントロールのサブ項目の (サブ) プロパティの値を設定します。

コントロールのプロパティのアクセス方法

コントロールのプロパティのアクセス方法の概要表

以下の表は、Infragistics コントロールのプロパティおよびサブプロパティにアクセスするメソッドについて説明します。表の操作レベル 列は、メソッドがコントロール全体 (コントロールの操作レベル - 全体のグリッドなど) に操作するか、部分 (サブ項目の操作レベル - グリッドのセルなど) に操作するかどうかを示します。表の後のテキスト ブロックに、メソッドの詳細情報が提供されています。

各メソッドのユーザー補助は、メソッドを呼び出すコントロールに固有です。詳細については、テスト可能なユーザー操作および要素 トピックで相対するコントロールのヘルプを参照してください。

メソッド 操作レベル 説明

コントロール

指定したコントロールまたはオブジェクトの表示可能なプロパティおよびそのデータ型のリストを返します。

コントロール

指定したコントロールのプロパティまたはサブプロパティの値を返します。

コントロール

指定したコントロールのプロパティまたはサブプロパティの値を設定します。

サブ項目

指定したコントロールのサブ項目の表示可能なプロパティのリストを返します。

サブ項目

指定したコントロールのサブ項目のプロパティまたはサブプロパティの値を返します。

サブ項目

指定したコントロールのサブ項目のプロパティまたはサブプロパティの値を設定します。

GetNAProperties

説明

ユーティリティ メソッド。GetNAProperties は、指定したコントロールまたはオブジェクトの表示可能なプロパティおよびそのデータ型のリストを返します。

詳細

返されたプロパティのリストで、カスタム定義された Test Automation プロパティは明示的に示されます。

返される文字列の値は、各プロパティを分割するために改行 (\n) を使用し、名前、データ型、とカスタム プロパティ インジケーターを分割するためにパイプ区切り「|」を使用します。

パラメーター

次の表は、メソッドのパラメーターを説明します。

メソッドのパラメーター 説明

oFullPropertyName

サブプロパティが返されるプロパティの名前。

空 (デフォルト値) の場合、メソッドはコントロール レベルのプロパティを返します。

コード例

例 1

UltraGrid で GetNAProperties メソッドを呼び出し、結果をメッセージ ボックスで表示します:

props = SwfWindow("MainWindow").SwfTable("grid").GetNAProperties
msgbox props

例 2

GetNAProperties メソッドを UltraGrid で呼び出し、結果を UltraGrid_Props.txt と呼ばれるテキスト ファイルに書き込みます。

fileName = "C:\ultraGrid_Props.txt"
Set grid = SwfWindow("MainWindow").SwfTable("grid")
Set fso = CreateObject("Scripting.FileSystemObject")
Set myFile = fso.CreateTextFile(fileName, true)
strProps = grid.GetNAProperties("")
aryProps = split(strProps, vbCRLF)
for index = 0 to ubound(aryProps)
aryProp = split(aryProps(index), "|")
for index2 = 0 to ubound(aryProp)
myFile.Write(aryProp(index2) & vbTab)
Next
myFile.WriteLine()
Next
myFile.Close()

例 3

GetNAProperties メソッドを呼び出し、 ViewSettings 値を持つ oFullPropertyName パラメーターを渡し、オブジェクト グリッドの ViewSettings プロパティのリストをメッセージ ボックスで返します。

props = SwfWindow("MainWindow").SwfTable("grid").GetNAProperties("ActiveCell")

msgbox props

GetNAProperty

説明

このメソッドは、指定したコントロールのプロパティまたはサブプロパティの値を返します。

サポートされるコントロール

すべての Infragistics コントロール。

パラメーター

次の表は、メソッドのパラメーターを説明します。

メソッドのパラメーター 説明

sFullPropertyName

この文字列は、取得されている値のプロパティの完全修飾名前を表します。

UltraGrid で GetNAProperty メソッドを呼び出し、結果をメッセージ ボックスで表示します:

Set grid = SwfWindow("MainWindow").SwfTable("grid")
props = grid.GetNAProperty("GesturesEnabled")
msgbox props

GetSubItemProperties

説明

ユーティリティ メソッド。GetSubItemProperties は指定したコントロールのサブ項目の表示可能なプロパティのリストを返します。

詳細

このメソッドは、指定したサブ項目のすべてのプロパティ名、データ型、およびプロパティがカスタム定義のテスト オートメーション プロパティであることを示すフラグを含むリストを返します。このメソッドから返される文字列は、各プロパティを分割するために改行 (\n) を使用し、名前、データ型、とカスタム プロパティ インジケーターを分割するためにパイプ区切り「|」を使用します。

サポートされるコントロール

  • WinSpreadSheet

パラメーター

次の表は、メソッドのパラメーターを説明します。

メソッドのパラメーター 説明

oeSubItemType

プロパティが属するサブ項目の型 (グリッド セルなど) を指定します。

oSubItem

プロパティが取得されているサブ項目を一意に識別します。

oFullPropertyName

サブプロパティが返されるプロパティの名前。

空 (デフォルト値) の場合、メソッドはサブ項目レベルのプロパティを返します。

コード例

例 1

サブ項目のプロパティを取得します。

以下のコードは、列の 3 つのグリッド セルのプロパティを取得し、結果をメッセージ ボックスに表示します。

set book = SwfWindow("MainWindow").SwfObject("ultraSpreadsheet1")
prop = book.GetSubItemProperties("sshtCell", "A3",)
msgbox prop

例 2

サブ項目の特定のプロパティのサブプロパティのリストを取得します。

オプションの oFullPropertyName パラメーターを提供すると、そのプロパティのサブプロパティのリストを取得できます。以下のコードは、oFullPropertyName に "Text" が渡され、セルの Text プロパティのサブプロパティを含むリストは返されます。set book = SwfWindow("MainWindow").SwfObject("ultraSpreadsheet1")

prop = book.GetSubItemProperties("sshtCell", "A3", "Text")

GetSubItemProperty

説明

このメソッドは、指定したコントロールのサブ項目のプロパティまたはサブプロパティの値を返します。

サポートされるコントロール

  • WinSpreadsheet

パラメーター

次の表は、メソッドのパラメーターを説明します。

メソッドのパラメーター 説明

oeSubItemType

取得されたプロパティが属するサブ項目の型 (グリッド セルなど) を指定します。

oSubItem

プロパティが取得されているサブ項目を一意に識別します。

sFullPropertyName

取得されている値のプロパティの完全修飾名前。

この例は SpreadSheetCell の Text プロパティを取得しますが、代わりにプロパティの値を返します。

Set book = SwfWindow("MainWindow").SwfObject("ultraSpreadsheet1")
prop = book.GetSubItemProperty("sshtCell", "A3", "Text")
msgbox prop

SetNAProperty

説明

このメソッドは、指定したコントロールのプロパティまたはサブプロパティの値を設定します。

サポートされるコントロール

すべての Ultimate UI for Windows Forms コントロール。

パラメーター

次の表は、メソッドのパラメーターを説明します。

メソッドのパラメーター 説明

sFullPropertyName

設定する値のプロパティの完全修飾名前。

oNewValue

プロパティが設定される新しい値。

ultraSpreadSheet1 と呼ばれる WinSpreadsheet の AreHeadersVisible プロパティの値を False に設定します。

Set book = SwfWindow("MainWindow").SwfObject("ultraSpreadsheet1")
book.SetNAProperty "AreHeadersVisible", "false"

SetSubItemProperty

説明

このメソッドは、指定したコントロールのサブ項目プロパティまたはサブプロパティの値を設定します。

サポートされるコントロール

  • WinSpreadsheet

パラメーター

次の表は、メソッドのパラメーターを説明します。

メソッドのパラメーター 説明

oeSubItemType

このパラメーターは、設定されているプロパティが属するサブ項目の型 (グリッド セルなど) を指定します。

oSubItem

このパラメーターは、プロパティが設定されているサブ項目を一意に識別します。

sFullPropertyName

このパラメーターは、取得されている値のプロパティの完全修飾名前を表す文字列です。

oNewValue

このパラメーターは、プロパティが設定する値。

USpreadsheetCell の値を設定します。

Set book = SwfWindow("MainWindow").SwfObject("ultraSpreadsheet1")
book.SetSubItemProperty "sshtCell", "A3", "Value", "42"

関連コンテンツ

トピック

このトピックに関連する追加情報については、以下のトピックを参照してください。

トピック 目的

このトピックでは、テストの作成、編集、および実行に関する参照情報を提供します。

このトピックでは、設定およびバージョン ユーティリティに関する参照情報を提供します。