IToolboxUser.GetToolSupported(ToolboxItem) Método

Definição

Namespace:

System.Drawing.Design

Assembly:

System.Windows.Forms.Design.dll

Obtém um valor que indica se a ferramenta especificada é compatível com o designer atual.

public:
 bool GetToolSupported(System::Drawing::Design::ToolboxItem ^ tool);

public bool GetToolSupported (System.Drawing.Design.ToolboxItem tool);

abstract member GetToolSupported : System.Drawing.Design.ToolboxItem -> bool

Public Function GetToolSupported (tool As ToolboxItem) As Boolean

Parâmetros

tool

ToolboxItem

O ToolboxItem a ser testado quanto à compatibilidade com a caixa de ferramentas.

Retornos

Boolean

true se a ferramenta for compatível com a caixa de ferramentas e puder ser habilitada; false se o designer do documento não souber como usar a ferramenta.

Exemplos

O exemplo de código a seguir demonstra uma implementação do GetToolSupported método .

// 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;
}

// 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;
}

' 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

Comentários

Se a ferramenta especificada tiver suporte do designer que implementa a IToolboxUser interface, a ferramenta será habilitada na caixa de ferramentas quando esse designer tiver o foco. Caso contrário, ela será desabilitada. Depois que uma ferramenta é marcada como habilitada ou desabilitada, ela pode não ser testada para obter suporte com o mesmo designer novamente.

Confira também

• ToolboxItem