Button.Right Propriedade

Definição

Namespace:

Microsoft.Office.Tools.Excel.Controls

Assembly:

Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Obtém a distância, em pontos, entre a borda direita do Button e a borda esquerda da planilha.

public double Right { get; }

Valor da propriedade

Double

A distância, em pontos, entre a borda direita do Button e a borda esquerda da planilha.

Exemplos

O exemplo de código a seguir adiciona um Button controle na célula B2. O Click manipulador de eventos do botão exibe os valores atuais das Right propriedades e Bottom do botão. Quando a coluna B ou a linha 2 é redimensionada em tempo de execução, esses valores mudam de acordo com o novo tamanho da coluna ou linha.

Este exemplo destina-se a uma personalização no nível de documento.

private void DisplayRightAndBottom()
{
    Microsoft.Office.Tools.Excel.Controls.Button pointButton =
        this.Controls.AddButton(this.Range["B2", "C3"],
        "pointButton");
    pointButton.Text = "Click to display location";
    pointButton.Click += new EventHandler(pointButton_Click);
}

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

    MessageBox.Show("Right is: " + clickedButton.Right.ToString() +
        "; Bottom is: " + clickedButton.Bottom.ToString());
}

Private Sub DisplayRightAndBottom()
    Dim PointButton As Microsoft.Office.Tools.Excel.Controls.Button = _
        Me.Controls.AddButton(Me.Range("B2", "C3"), "PointButton")
    PointButton.Text = "Click to display location"
    AddHandler PointButton.Click, AddressOf PointButton_Click
End Sub

Private Sub PointButton_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)

    MsgBox("Right is: " & ClickedButton.Right.ToString() & _
        "; Bottom is: " & ClickedButton.Bottom.ToString())
End Sub

Comentários

O valor da Right propriedade é igual à soma do valor da Left propriedade e do valor da Width propriedade.

A Microsoft.Office.Tools.Excel.Controls.Button.Right propriedade usa pontos, enquanto System.Windows.Forms.Control.Right a propriedade usa pixels.

A definição do valor como um número negativo ou um número maior que 12288 não lança uma exceção, mas resulta no controle definido entre 0 e 12288.