IToolboxUser.GetToolSupported メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

IToolboxUser.GetToolSupported メソッド

指定したツールが現在のデザイナでサポートされているかどうかを示す値を取得します。

名前空間: System.Drawing.Design
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Function GetToolSupported ( _
    tool As ToolboxItem _
) As Boolean

Visual Basic (使用法)

Dim instance As IToolboxUser
Dim tool As ToolboxItem
Dim returnValue As Boolean

returnValue = instance.GetToolSupported(tool)

bool GetToolSupported (
    ToolboxItem tool
)

C++

bool GetToolSupported (
    ToolboxItem^ tool
)

boolean GetToolSupported (
    ToolboxItem tool
)

JScript

function GetToolSupported (
    tool : ToolboxItem
) : boolean

パラメータ

tool: ツールボックスでサポートされているかどうかをテストする対象の ToolboxItem。

戻り値
ツールボックスでツールがサポートされていて有効にできる場合は true。ドキュメントデザイナでツールの使用方法が認識されない場合は false。

解説

IToolboxUser を実装するデザイナで、指定したツールがサポートされている場合は、そのデザイナがフォーカスを取得したときに、そのツールがツールボックス内で有効になります。それ以外の場合、ツールは無効になります。ツールが有効または無効としてマークされた後は、同じデザイナでそのツールがサポートされているかどうかを再テストすることはできません。

使用例

GetToolSupported メソッドの実装例を次に示します。

Visual Basic

' This method can signal whether to enable or disable the specified
' ToolboxItem when the component associated with this designer is selected.
Function GetToolSupported(ByVal tool As
 ToolboxItem) As Boolean Implements
 IToolboxUser.GetToolSupported
    ' Search the blocked type names array for the type name of the tool
    ' for which support for is being tested. Return false to indicate
 the
    ' tool should be disabled when the associated component is selected.
    Dim i As Integer
    For i = 0 To blockedTypeNames.Length -
 1
        If tool.TypeName = blockedTypeNames(i) Then
            Return False
        End If
    Next i ' Return true to indicate support for
 the tool, if the type name of the
    ' tool is not located in the blockedTypeNames string array.
    Return True
End Function

// This method can signal whether to enable or disable the specified
// ToolboxItem when the component associated with this designer is selected.
bool IToolboxUser.GetToolSupported(ToolboxItem tool)
{       
    // Search the blocked type names array for the type name of the
 tool
    // for which support for is being tested. Return false to indicate
 the
    // tool should be disabled when the associated component is selected.
    for( int i=0; i<blockedTypeNames.Length;
 i++ )
        if( tool.TypeName == blockedTypeNames[i] )
            return false;
    
    // Return true to indicate support for the tool, if the type name
 of the
    // tool is not located in the blockedTypeNames string array.
    return true;
}