ControlExtensions.AddLinkLabel Método
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.
Sobrecargas
| AddLinkLabel(ControlCollection, Range, String) |
Adiciona um novo controle LinkLabel à planilha no intervalo especificado. |
| AddLinkLabel(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um novo controle LinkLabel à planilha no local e no tamanho especificados. |
AddLinkLabel(ControlCollection, Range, String)
Adiciona um novo controle LinkLabel à planilha no intervalo especificado.
public static Microsoft.Office.Tools.Excel.Controls.LinkLabel AddLinkLabel (this Microsoft.Office.Tools.Excel.ControlCollection controls, Microsoft.Office.Interop.Excel.Range range, string name);
Parâmetros
- controls
- ControlCollection
A coleção a ser adicionada ao controle. Não forneça esse parâmetro. Quando você chama esse método na coleção retornada pela propriedade Controls (em um projeto no nível de aplicativo) ou Controls (em um projeto no nível de documento), esse parâmetro é fornecido automaticamente.
- name
- String
O nome do controle que pode ser usado para indexar o controle na instância de ControlCollection.
Retornos
O controle LinkLabel adicionado à instância ControlCollection.
Exceções
O argumento de nome ou intervalo é null, ou o argumento de nome tem comprimento zero.
Um controle com o mesmo nome já está na instância de ControlCollection.
O intervalo que foi especificado não é válido. Os intervalos de várias áreas não podem ser usados. O intervalo deve estar na mesma planilha que a instância de ControlCollection.
Exemplos
O exemplo de código a seguir adiciona um LinkLabel controle à célula a1e, em seguida, altera o texto para First Name . Em seguida, o código altera a cor do link para azul e define o LinkBehavior para HoverUnderline . Para usar esse exemplo, execute-o na classe Sheet1 em um projeto no nível de documento.
private void ExcelAddLinkLabel()
{
Microsoft.Office.Tools.Excel.Controls.LinkLabel
linkLabel1 = this.Controls.AddLinkLabel(
0, 0, 75, 17.25, "linkLabel1");
linkLabel1.Text = "First Name";
linkLabel1.LinkColor = Color.Blue;
linkLabel1.LinkBehavior = LinkBehavior.HoverUnderline;
}
Private Sub ExcelAddLinkLabel()
Dim LinkLabel1 As Microsoft.Office.Tools.Excel. _
Controls.LinkLabel = Me.Controls.AddLinkLabel( _
0, 0, 75, 17.25, "LinkLabel1")
LinkLabel1.Text = "First Name"
LinkLabel1.LinkColor = Color.Blue
LinkLabel1.LinkBehavior = LinkBehavior.HoverUnderline
End Sub
Comentários
O AddLinkLabel método permite que você adicione LinkLabel objetos ao final do ControlCollection . Para remover um LinkLabel que foi anteriormente adicionado programaticamente, use o Remove método.
O controle é redimensionado automaticamente quando o intervalo é redimensionado.
Aplica-se a
AddLinkLabel(ControlCollection, Double, Double, Double, Double, String)
Adiciona um novo controle LinkLabel à planilha no local e no tamanho especificados.
public static Microsoft.Office.Tools.Excel.Controls.LinkLabel AddLinkLabel (this Microsoft.Office.Tools.Excel.ControlCollection controls, double left, double top, double width, double height, string name);
Parâmetros
- controls
- ControlCollection
A coleção a ser adicionada ao controle. Não forneça esse parâmetro. Quando você chama esse método na coleção retornada pela propriedade Controls (em um projeto no nível de aplicativo) ou Controls (em um projeto no nível de documento), esse parâmetro é fornecido automaticamente.
- left
- Double
A distância em pontos entre a borda esquerda do controle e a borda esquerda da planilha.
- top
- Double
A distância em pontos entre a borda superior do controle e a borda superior da planilha.
- width
- Double
A largura do controle em pontos.
- height
- Double
A altura do controle em pontos.
- name
- String
O nome do controle.
Retornos
O controle LinkLabel adicionado à instância ControlCollection.
Exceções
O argumento de nome é null ou tem comprimento zero.
Um controle com o mesmo nome já está na instância de ControlCollection.
Exemplos
O exemplo de código a seguir adiciona um LinkLabel controle à parte superior da planilha e, em seguida, altera o texto para First Name . Em seguida, o código altera a cor do link para azul e define o LinkBehavior para HoverUnderline . Para usar esse exemplo, execute-o na classe Sheet1 em um projeto no nível de documento.
private void ExcelRangeAddListBox()
{
Microsoft.Office.Tools.Excel.Controls.ListBox
listBox1 = this.Controls.AddListBox(
this.Range["A1", "B6"], "lisBox1");
listBox1.Items.Add("First Item");
listBox1.Items.Add("Second Item");
listBox1.SelectedIndex = 0;
}
Private Sub ExcelRangeAddListBox()
Dim ListBox1 As Microsoft.Office.Tools.Excel. _
Controls.ListBox = Me.Controls.AddListBox( _
Me.Range("A1", "B6"), "ListBox1")
ListBox1.Items.Add("First Item")
ListBox1.Items.Add("Second Item")
ListBox1.SelectedIndex = 0
End Sub
Comentários
O AddLinkLabel método permite que você adicione LinkLabel objetos ao final do ControlCollection . Para remover um LinkLabel controle que foi previamente adicionado programaticamente, use o Remove método.