FromKeyButton メソッド (Items)

Key プロパティに基づく ツールバー項目コレクションの文字列インデクサーー。

シンタックス

Visual Basic

'宣言
 
Public Function FromKeyButton( _
   ByVal key As String _
) As TBarButton

C#

public TBarButton FromKeyButton( 
   string key
)

パラメータ

key

戻り値の型

指定した key を使用して最初に見つかった TBarButton のインスタンス。該当するボタンが見つからなかった場合は null (Visual Basic .NET では Nothing)。

解説

このインデクサーメソッドは、サブクラス化したボタンを正しくサポートしていないので、廃止されます。開発者は、Web アプリケーションにより高い柔軟性を持たせることができる場合には、FromKeyIButton を採用する必要があります。

指定の key の項目が見つかった場合、TBarButton 型であるかどうかの確認が処理されます。正しいタイプでない場合、Null が返されます。重複キーが複数のタイプの項目にわたって存在する場合、 keyに一致する最初のオブジェクトが異なるタイプであると、 コレクション内に存在するオブジェクトは見つからないと報告される場合があります。

キーの比較は、大文字と小文字を区別して行われます。

同じ Key 値を持つ複数のボタンをツールバー項目のコレクションに追加しないようにするのは、 アプリケーション開発者側の責任です。最適なパフォーマンスと堅牢性を得るため、同一の UltraWebToolbar 内に重複キーを使用しないことを強くお勧めします。