Chart.ApplyLayout (Método)
Aplica los diseños mostrados en la cinta de opciones.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
Sub ApplyLayout ( _
Layout As Integer, _
ChartType As Object _
)
void ApplyLayout(
int Layout,
Object ChartType
)
Parámetros
- Layout
Tipo: System.Int32
Entero del 1 al 10 que especifica el tipo de diseño que se va a aplicar al gráfico.
- ChartType
Tipo: System.Object
Uno de los valores de Microsoft.Office.Interop.Excel.XlChartType.
Comentarios
Los valores del parámetro Layout corresponden a las opciones disponibles en el grupo Diseños de gráfico de la ficha Diseño en la cinta de opciones. La ficha Diseño está disponible cuando se selecciona un gráfico.
Cada tipo de gráfico tiene su propio conjunto de opciones de diseño. Por ejemplo, las opciones de diseño para un gráfico circular son diferentes de las opciones de diseño para un gráfico de columnas. Si desea aplicar el diseño de un tipo de gráfico diferente, puede usar el parámetro ChartType para especificar el tipo de gráfico al que el parámetro Layout va a hacer referencia. Por ejemplo, si tiene un gráfico de columnas y desea aplicar un diseño de un gráfico de líneas, pase el valor XlChartType.xlLine al parámetro ChartType. El diseño sólo agrega los elementos de gráfico que están disponibles para ese tipo de gráfico.
Parámetros opcionales
Para obtener información sobre los parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
En el ejemplo de código siguiente se aplica el décimo diseño disponible para el tipo de gráfico del gráfico Chart_1. Además, en el ejemplo se usa el método SetElement para aplicar otros cambios de diseño: establecer el estilo del título del gráfico para que esté centrado y para que se coloque dentro del área de cuadrícula del gráfico, agregar un título para el eje horizontal y agregar un título girado para el eje vertical. Para ejecutar este ejemplo de código, debe agregar un gráfico bidimensional de columnas agrupadas con el nombre Chart_1 a la hoja predeterminada Sheet1.
Private Sub DesignChart()
Dim myChart As Microsoft.Office.Tools.Excel.Chart = _
Globals.Sheet1.Chart_1
myChart.ApplyLayout(10)
myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
msoElementChartTitleCenteredOverlay)
myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
msoElementPrimaryCategoryAxisTitleHorizontal)
myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
msoElementPrimaryValueAxisTitleRotated)
End Sub
private void DesignChart()
{
Microsoft.Office.Tools.Excel.Chart myChart =
Globals.Sheet1.Chart_1;
myChart.ApplyLayout(10, myChart.ChartType);
myChart.SetElement(
Microsoft.Office.Core.MsoChartElementType.
msoElementChartTitleCenteredOverlay);
myChart.SetElement(
Microsoft.Office.Core.MsoChartElementType.
msoElementPrimaryCategoryAxisTitleHorizontal);
myChart.SetElement(
Microsoft.Office.Core.MsoChartElementType.
msoElementPrimaryValueAxisTitleRotated);
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.