Formato numérico para eixo em um gráfico
Este tutorial explica como usar Aspose.Words for .NET para definir o formato numérico de um eixo em um gráfico. O código-fonte fornecido demonstra como criar um gráfico, adicionar dados de série e formatar os rótulos dos eixos.
Etapa 1: configurar o projeto
Certifique-se de ter os seguintes pré-requisitos:
- Biblioteca Aspose.Words para .NET instalada. Você pode baixá-lo usando o gerenciador de pacotes NuGet para instalá-lo.
- Um caminho do diretório do documento onde o documento de saída será salvo.
Passo 2: Crie um novo documento e insira um gráfico
Crie um novoDocument
objeto e umDocumentBuilder
para construir o documento.
// Caminho para o diretório do seu documento
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
A seguir, use oInsertChart
método doDocumentBuilder
para inserir um gráfico de colunas no documento.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
Chart chart = shape.Chart;
Etapa 3: adicionar dados de série ao gráfico
Adicione dados de série ao gráfico. Neste exemplo, adicionaremos cinco itens com seus valores correspondentes.
chart.Series.Clear();
chart.Series.Add("Aspose Series 1",
new string[] { "Item 1", "Item 2", "Item 3", "Item 4", "Item 5" },
new double[] { 1900000, 850000, 2100000, 600000, 1500000 });
Etapa 4: formate os rótulos dos eixos
Para definir o formato numérico para os rótulos do eixo Y, acesse oAxisY
propriedade do gráfico e defina oNumberFormat.FormatCode
propriedade para o formato desejado. Neste exemplo, definimos o formato como “#,##0” para exibir números com separadores de milhares.
chart.AxisY.NumberFormat.FormatCode = "#,##0";
Etapa 5: salve o documento
Finalmente, salve o documento no diretório especificado usando oSave
método doDocument
objeto.
doc.Save(dataDir + "WorkingWithCharts.NumberFormatForAxis.docx");
Isso conclui a implementação da configuração do formato numérico do eixo usando Aspose.Words for .NET.
Exemplo de código-fonte para Number Format For Axis usando Aspose.Words for .NET
// Caminho para o diretório do seu documento
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
Chart chart = shape.Chart;
chart.Series.Clear();
chart.Series.Add("Aspose Series 1",
new string[] { "Item 1", "Item 2", "Item 3", "Item 4", "Item 5" },
new double[] { 1900000, 850000, 2100000, 600000, 1500000 });
chart.AxisY.NumberFormat.FormatCode = "#,##0";
doc.Save(dataDir + "WorkingWithCharts.NumberFormatForAxis.docx");
Conclusão
Neste tutorial, você aprendeu como definir o formato numérico de um eixo em um gráfico usando Aspose.Words for .NET. Seguindo o guia passo a passo e utilizando o código-fonte fornecido, você pode criar um novo documento, inserir um gráfico de colunas, adicionar dados de série e formatar os rótulos dos eixos para exibir números em um formato específico.
Aspose.Words for .NET fornece recursos poderosos para personalizar a aparência de gráficos em documentos do Word. Ao definir o formato numérico dos rótulos dos eixos, você pode controlar como os números são exibidos, incluindo opções como casas decimais, separadores de milhares, símbolos de moeda e muito mais. Isso permite apresentar dados numéricos de forma clara e significativa.
Com Aspose.Words for .NET, você tem flexibilidade para formatar vários aspectos do gráfico, incluindo os rótulos dos eixos. Ao definir o formato numérico do eixo, você pode garantir consistência e melhorar a legibilidade do gráfico, facilitando a interpretação dos valores representados pelos usuários.
Perguntas frequentes
Q1. Qual é o formato numérico de um eixo em um gráfico?
O formato numérico de um eixo em um gráfico refere-se à formatação aplicada aos valores numéricos exibidos no eixo. Ele permite controlar como os números são apresentados, incluindo opções como casas decimais, separadores de milhares, símbolos de moeda, sinais de porcentagem e muito mais. Ao definir o formato numérico, você pode personalizar a aparência dos dados numéricos no gráfico para atender às suas necessidades específicas.
Q2. Como posso definir o formato numérico dos rótulos dos eixos?
Para definir o formato numérico para os rótulos dos eixos em um gráfico usando Aspose.Words for .NET, você pode acessar oAxisY
propriedade do gráfico e defina oNumberFormat.FormatCode
propriedade para o código de formato desejado. O código de formato segue a sintaxe dos padrões de formatação numérica padrão e determina como os números são exibidos. Por exemplo, você pode usar “#,##0,00” para exibir números com duas casas decimais e separadores de milhar.
Q3. Posso definir formatos numéricos diferentes para os rótulos dos eixos X e Y?
Sim, você pode definir diferentes formatos numéricos para os rótulos do eixo X e do eixo Y usando Aspose.Words for .NET. Acesse o respectivo eixo (AxisX
para eixo X ouAxisY
para o eixo Y) do gráfico e modifique oNumberFormat.FormatCode
propriedade individualmente para cada eixo. Isso permite que você aplique diferentes formatos de números aos rótulos de cada eixo com base em seus requisitos específicos.
Q4. Quais são alguns códigos de formato numérico comuns que posso usar?
Aspose.Words for .NET oferece suporte a uma ampla variedade de códigos de formato numérico que você pode usar para formatar os rótulos dos eixos em um gráfico. Alguns códigos de formato comuns incluem:
0
ou#
- Exibe o número sem casas decimais.0.00
ou#.00
- Exibe o número com duas casas decimais.#,##0
Exibe o número com separadores de milhares."€"0.00
- Exibe o número com o símbolo da moeda Euro e duas casas decimais."%"0
- Exibe o número como uma porcentagem.
Você pode encontrar mais informações sobre o númerocódigos de formato na Referência da API do Aspose.Words para .NET.
Q5. Posso personalizar outras propriedades dos rótulos dos eixos?
Sim, Aspose.Words for .NET fornece uma ampla gama de propriedades para personalizar a aparência e o comportamento dos rótulos dos eixos. Além do formato numérico, você pode modificar propriedades como fonte, tamanho, cor, orientação, alinhamento e muito mais. Isso permite que você personalize totalmente os rótulos dos eixos para corresponder ao estilo e aos requisitos de apresentação desejados.