NamedRange.Insert(Object, Object) 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.
Insere uma célula ou um intervalo de células no controle NamedRange e desloca outras células para liberar espaço.
public object Insert (object Shift, object CopyOrigin);
Parâmetros
- Shift
- Object
Especifica em que direção deslocar as células. Pode ser um dos seguintes valores de XlInsertShiftDirection: xlShiftToRight ou xlShiftDown. Se esse argumento for omitido, o Microsoft Office Excel decidirá com base na forma do intervalo.
- CopyOrigin
- Object
Um dos valores de XlInsertFormatOrigin que especifica onde obter o formato para aplicar as novas células.
Retornos
Exemplos
O exemplo de código a seguir define valores nas células A1 a a3 e, em seguida, usa o Insert método para inserir uma célula em branco em um NamedRange controle chamado NamedRange1 que é definido como a célula a1. Essa operação alterna as células no intervalo para baixo, o que significa que NamedRange1 agora está definido como a célula A2. Para demonstrar isso, o exemplo define o valor de NamedRange1 para Raven , que é exibido na célula A2.
Este exemplo destina-se a uma personalização no nível de documento.
private void InsertIntoRange()
{
this.Range["A1"].Value2 = "Robin";
this.Range["A2"].Value2 = "Sparrow";
this.Range["A3"].Value2 = "Crow";
Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
this.Controls.AddNamedRange(this.Range["A1"],
"namedRange1");
namedRange1.Insert(Excel.XlInsertShiftDirection.xlShiftDown);
namedRange1.Value2 = "Raven";
}
Private Sub InsertIntoRange()
Me.Range("A1").Value2 = "Robin"
Me.Range("A2").Value2 = "Sparrow"
Me.Range("A3").Value2 = "Crow"
Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
= Me.Controls.AddNamedRange(Me.Range("A1"), _
"namedRange1")
namedRange1.Insert(Excel.XlInsertShiftDirection.xlShiftDown, )
namedRange1.Value2 = "Raven"
End Sub
Comentários
Parâmetros opcionais
Para obter informações sobre parâmetros opcionais, consulte parâmetros opcionais em soluções do Office.