Propriedade Button.Creator

Artigo
08/01/2011

Obtém um valor que indica o aplicativo no qual o Button foi criado.

Namespace: Microsoft.Office.Tools.Excel.Controls
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
Public ReadOnly Property Creator As XlCreator
    Get

public XlCreator Creator { get; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Excel.XlCreator
The xlCreatorCode.

Comentários

Porque o Button foi criado no Excel de Microsoft Office, essa propriedade retorna a seqüência XCEL, que é equivalente ao hexadecimal número 5843454C.

Exemplos

O exemplo de código a seguir adiciona um Button o controle para a planilha atual. O Click o manipulador de eventos para este botão exibe os valores da Creator e Application Propriedades.

Este exemplo é para uma personalização em nível de documento.

Private Sub DisplayCreatorAndApplication()
    Dim CreatorButton1 As Microsoft.Office.Tools.Excel.Controls.Button = _
        Me.Controls.AddButton(Me.Range("B2", "C3"), "CreatorButton1")
    CreatorButton1.Text = "Click to view creator and application"
    AddHandler CreatorButton1.Click, AddressOf CreatorButton_Click
End Sub

Private Sub CreatorButton_Click(ByVal sender As Object, ByVal e As EventArgs)
    Dim ClickedButton As Microsoft.Office.Tools.Excel.Controls.Button = _
        CType(sender, Microsoft.Office.Tools.Excel.Controls.Button)

    Dim ApplicationString As String = "The current application is " & _
        ClickedButton.Application.Name.ToString()

    If ClickedButton.Creator = Excel.XlCreator.xlCreatorCode Then
        MsgBox(ApplicationString & ". Created by Microsoft Excel")
    Else
        MsgBox(ApplicationString & _
            ". Created by an application other than Microsfot Excel")
    End If
End Sub

private void DisplayCreatorAndApplication()
{
    Microsoft.Office.Tools.Excel.Controls.Button creatorButton1 =
            this.Controls.AddButton(this.Range["B2", "C3"],
            "creatorButton1");
    creatorButton1.Text = "Click to view creator and application";
    creatorButton1.Click += new EventHandler(creatorButton_Click);
}

void creatorButton_Click(object sender, EventArgs e)
{
    Microsoft.Office.Tools.Excel.Controls.Button clickedButton =
        (Microsoft.Office.Tools.Excel.Controls.Button)sender;

    string applicationString = "The current application is " +
        clickedButton.Application.Name.ToString();

    if (clickedButton.Creator == Excel.XlCreator.xlCreatorCode)
    {
        MessageBox.Show(applicationString +
            ". Created by Microsoft Excel");
    }
    else
    {
        MessageBox.Show(applicationString +
            ". Created by an application other than Microsfot Excel");
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Button Classe

Namespace Microsoft.Office.Tools.Excel.Controls

Compartilhar via