Button.Top Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define a distância, em pontos, entre a borda superior do Button e a borda superior da planilha.
public double Top { get; set; }
Valor da propriedade
A distância, em pontos, entre a borda superior do Button e a borda superior da planilha.
Exemplos
O exemplo de código a seguir compara o comportamento de redimensionamento e realocação de dois controles Button a uma planilha. O manipulador de eventos Click do primeiro botão ajusta as propriedades Height e Width do botão de forma que o botão mude de tamanho, mas permaneça no mesmo local da planilha. O Click manipulador de eventos do segundo botão ajusta as Top Propriedades e Left do botão para que o botão altere o local na planilha, mas permanece com o mesmo tamanho.
Este exemplo destina-se a uma personalização no nível de documento.
private void ModifySizeAndLocation()
{
Microsoft.Office.Tools.Excel.Controls.Button sizeButton =
this.Controls.AddButton(25, 30, 100, 25,
"sizeButton");
sizeButton.Name = "sizeButton";
sizeButton.Text = "Click to resize";
sizeButton.Click += new EventHandler(pointButtons_Click);
Microsoft.Office.Tools.Excel.Controls.Button locationButton =
this.Controls.AddButton(25, 150, 100, 25,
"locationButton");
locationButton.Name = "locationButton";
locationButton.Text = "Click to move";
locationButton.Click += new EventHandler(pointButtons_Click);
}
// Represents the toggle states of the buttons.
bool toggleState1 = true;
bool toggleState2 = true;
void pointButtons_Click(object sender, EventArgs e)
{
Microsoft.Office.Tools.Excel.Controls.Button clickedButton =
(Microsoft.Office.Tools.Excel.Controls.Button)sender;
// Toggle the Height and Width of sizeButton.
if (clickedButton.Name == "sizeButton")
{
if (toggleState1)
{
clickedButton.Height = 40;
clickedButton.Width = 80;
toggleState1 = false;
}
else
{
clickedButton.Height = 25;
clickedButton.Width = 100;
toggleState1 = true;
}
}
// Toggle the Left and Top of locationButton.
else
{
if (toggleState2)
{
clickedButton.Left = 50;
clickedButton.Top = 100;
toggleState2 = false;
}
else
{
clickedButton.Left = 25;
clickedButton.Top = 150;
toggleState2 = true;
}
}
}
Private Sub ModifySizeAndLocation()
Dim SizeButton As Microsoft.Office.Tools.Excel.Controls.Button = _
Me.Controls.AddButton(25, 30, 100, 25, "SizeButton")
SizeButton.Name = "SizeButton"
SizeButton.Text = "Click to resize"
AddHandler SizeButton.Click, AddressOf PointButtons_Click
Dim LocationButton As Microsoft.Office.Tools.Excel.Controls.Button = _
Me.Controls.AddButton(25, 150, 100, 25, "LocationButton")
LocationButton.Name = "LocationButton"
LocationButton.Text = "Click to move"
AddHandler LocationButton.Click, AddressOf PointButtons_Click
End Sub
' Represents the toggle states of the buttons.
Private toggleState1 As Boolean = True
Private toggleState2 As Boolean = True
Private Sub PointButtons_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)
' Toggle the Height and Width of sizeButton.
If ClickedButton.Name = "SizeButton" Then
If toggleState1 Then
ClickedButton.Height = 40
ClickedButton.Width = 80
toggleState1 = False
Else
ClickedButton.Height = 25
ClickedButton.Width = 100
toggleState1 = True
End If
' Toggle the Left and Top of locationButton.
Else
If toggleState2 Then
ClickedButton.Left = 50
ClickedButton.Top = 100
toggleState2 = False
Else
ClickedButton.Left = 25
ClickedButton.Top = 150
toggleState2 = True
End If
End If
End Sub
Comentários
A Microsoft.Office.Tools.Excel.Controls.Button.Top propriedade usa pontos, enquanto a System.Windows.Forms.Control.Top propriedade usa pixels.