Namngivna intervall

Vanligtvis används kolumn- och radetiketter för att hänvisa till enskilda celler. Det är möjligt att skapa beskrivande namn för att representera celler, cellintervall, formler eller konstanta värden. Ordet namn kan hänvisa till en sträng av tecken som representerar en cell, ett cellintervall, en formel eller ett konstant värde. Genom att tilldela ett namn till ett intervall betyder det att det intervallet kan hänvisas till med sitt namn. Använd lättförståeliga namn, såsom Produkter, för att hänvisa till svårförståeliga intervall, såsom Försäljning!C20:C30. Etiketter kan användas i formler som hänvisar till data på samma kalkylblad; om du vill representera ett intervall på ett annat kalkylblad kan du använda ett namn. Namngivna intervall är bland de mest kraftfulla funktionerna i Microsoft Excel, särskilt när de används som källintervall för listkontroller, pivottabeller, diagram osv.

Skapa en namngiven omfattning

Använda Microsoft Excel

Följande steg beskriver hur man namnger en cell eller ett cellintervall med Microsoft Excel. Denna metod gäller för Microsoft Office Excel 2003, Microsoft Excel 97, 2000 och 2002.

1. Välj cellen, cellområdet som du vill namnge.
2. Klicka på Namn ruta längst till vänster om formelfältet.
3. Skriv namnet för cellerna.
4. Tryck på ENTER.

Du kan inte namnge en cell medan du ändrar innehållet i cellen.

Använda Aspose.Cells

Här använder vi Aspose.Cells API för att utföra uppgiften.

Aspose.Cells tillhandahåller en klass, Workbook, som representerar en Microsoft Excel-fil. Workbook-klassen innehåller en WorksheetCollection som möjliggör åtkomst till varje kalkylblad i en Excel-fil. Ett kalkylblad representeras av klassen Worksheet. Klassen Worksheet tillhandahåller en Cells-samling.

Det är möjligt att skapa ett namngivet intervall genom att anropa den överbelastade createRange-metoden i Cells-samlingen. En vanlig version av createRange-metoden tar följande parametrar:

• Namn på övre vänstra cell, namnet på den översta vänstra cellen i intervallet.
• Namnet på den nedre högra cellen, namnet på den längst ner till höger i området.

När createRange-metoden anropas returnerar den det nyligen skapade namngivna intervallet som en instans av Range-klassen.

Följande exempel visar hur man skapar ett namngivet intervall av celler som sträcker sig över B4:G14.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(CreateNamedRangeofCells.class) + "data/";

// Instantiating a Workbook object
Workbook workbook = new Workbook(dataDir + "book1.xls");

WorksheetCollection worksheets = workbook.getWorksheets();

// Accessing the first worksheet in the Excel file
Worksheet sheet = worksheets.get(0);
Cells cells = sheet.getCells();

// Creating a named range
Range namedRange = cells.createRange("B4", "G14");
namedRange.setName("TestRange");

// Saving the modified Excel file in default (that is Excel 2000) format
workbook.save(dataDir + "CNROfCells_out.xls");

// Print message
System.out.println("Process completed successfully");

Åtkomst till alla namngivna intervall i ett kalkylblad

Anropa getNamedRanges-metoden i WorksheetCollection för att få alla namngivna intervall i ett kalkylblad. getNamedRanges-metoden returnerar en matris med alla namngivna intervall i WorksheetCollection.

Följande exempel visar hur man åtkommer alla namngivna områden i en arbetsbok.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AccessAllNamedRanges.class) + "data/";

// Instantiating a Workbook object
Workbook workbook = new Workbook(dataDir + "book1.xls");

WorksheetCollection worksheets = workbook.getWorksheets();

// Accessing the first worksheet in the Excel file
Worksheet sheet = worksheets.get(0);
Cells cells = sheet.getCells();

// Getting all named ranges
Range[] namedRanges = worksheets.getNamedRanges();

// Print message
System.out.println("Number of Named Ranges : " + namedRanges.length);

Åtkomst till ett specifikt namngivet område

Anropa WorksheetCollections- samlingens getRangeByName-metod för att få ett specifierat intervall efter namn. En vanlig getRangeByName-metod tar namnet på namngivet intervallet och returnerar det specifierade namngivna intervallet som en instans av Range-klassen.

Följande exempel visar hur man får åtkomst till ett specifierat intervall efter dess namn.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AccessSpecificNamedRange.class) + "data/";

// Instantiating a Workbook object
Workbook workbook = new Workbook(dataDir + "book1.xls");

WorksheetCollection worksheets = workbook.getWorksheets();

// Accessing the first worksheet in the Excel file
Worksheet sheet = worksheets.get(0);
Cells cells = sheet.getCells();

// Getting the specified named range
Range namedRange = worksheets.getRangeByName("TestRange");

// Print message
System.out.println("Named Range : " + namedRange.getRefersTo());

Identifiera celler i ett namngivet intervall

Med Aspose.Cells kan du infoga data i de enskilda cellerna i ett intervall. Anta att du har ett namngivet intervall av celler, d.v.s., A1:C4. Så skulle matrisen göra 4 * 3 = 12 celler och de enskilda intervallscellerna är ordnade sekventiellt. Aspose.Cells tillhandahåller dig några användbara egenskaper i Range-klassen för att få åtkomst till de enskilda cellerna i intervallet. Du kan använda följande metoder för att identifiera cellerna i intervallet:

• getFirstRow returnerar index för den första raden i det namngivna intervallet.
• getFirstColumn returnerar index för den första kolumnen i det namngivna intervallet.

Följande exempel visar hur man anger några värden i cellerna i ett specificerat område.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(IdentifyCellsinNamedRange.class) + "data/";

// Instantiating a Workbook object
Workbook workbook = new Workbook(dataDir + "book1.xls");

WorksheetCollection worksheets = workbook.getWorksheets();

// Accessing the first worksheet in the Excel file
Worksheet sheet = worksheets.get(0);
Cells cells = sheet.getCells();

// Getting the specified named range
Range range = worksheets.getRangeByName("TestRange");

// Identify range cells.
System.out.println("First Row : " + range.getFirstRow());
System.out.println("First Column : " + range.getFirstColumn());
System.out.println("Row Count : " + range.getRowCount());
System.out.println("Column Count : " + range.getColumnCount());

Ange data i cellerna i det namngivna området

Med Aspose.Cells kan du infoga data i de enskilda cellerna i ett intervall. Anta att du har ett namngivet intervall av celler d.v.s., H1:J4. Så skulle matrisen göra 4 * 3 = 12 celler och de enskilda intervallscellerna är ordnade sekventiellt. Aspose.Cells tillhandahåller dig några användbara egenskaper i Range-klassen för att få åtkomst till de enskilda cellerna i intervallet. Du kan använda följande egenskaper för att identifiera cellerna i intervallet:

• getFirstRow returnerar index för den första raden i det namngivna intervallet.
• getFirstColumn returnerar index för den första kolumnen i det namngivna intervallet.

Följande exempel visar hur man anger några värden i cellerna i ett specificerat område.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(InputDataInCellsInRange.class) + "data/";

// Instantiate a new Workbook.
Workbook workbook = new Workbook();

// Get the first worksheet in the workbook.
Worksheet worksheet1 = workbook.getWorksheets().get(0);

// Create a range of cells and specify its name based on H1:J4.
Range range = worksheet1.getCells().createRange("H1:J4");
range.setName("MyRange");

// Input some data into cells in the range.
range.get(0, 0).setValue("USA");
range.get(0, 1).setValue("SA");
range.get(0, 2).setValue("Israel");
range.get(1, 0).setValue("UK");
range.get(1, 1).setValue("AUS");
range.get(1, 2).setValue("Canada");
range.get(2, 0).setValue("France");
range.get(2, 1).setValue("India");
range.get(2, 2).setValue("Egypt");
range.get(3, 0).setValue("China");
range.get(3, 1).setValue("Philipine");
range.get(3, 2).setValue("Brazil");

// Save the excel file.
workbook.save(dataDir + "IDICInRange_out.xls");

// Print message
System.out.println("Process completed successfully");

Formatera intervall… Ställa in bakgrundsfärg och fontattribut för ett namngivet intervall

För att applicera formatering, definiera en Style-objekt för att ange stilinställningar och applicera det på Range-objektet.

Följande exempel visar hur du ställer in en fyllningsfärg (skuggfärg) med teckensnittsinställningar för ett intervall.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(FormatRanges1.class) + "data/";

// Instantiate a new Workbook.
Workbook workbook = new Workbook();

// Get the first worksheet in the book.
Worksheet WS = workbook.getWorksheets().get(0);

// Create a named range of cells.
com.aspose.cells.Range range = WS.getCells().createRange(1, 1, 1, 17);
range.setName("MyRange");

// Declare a style object.
Style stl;

// Create the style object with respect to the style of a cell.
stl = WS.getCells().get(1, 1).getStyle();

// Specify some Font settings.
stl.getFont().setName("Arial");
stl.getFont().setBold(true);

// Set the font text color
stl.getFont().setColor(Color.getRed());

// To Set the fill color of the range, you may use ForegroundColor with
// solid Pattern setting.
stl.setBackgroundColor(Color.getYellow());
stl.setPattern(BackgroundType.SOLID);

// Apply the style to the range.
for (int r = 1; r < 2; r++) {
	for (int c = 1; c < 18; c++) {
		WS.getCells().get(r, c).setStyle(stl);
	}

}

// Save the excel file.
workbook.save(dataDir + "FormatRanges1_out.xls");

// Print message
System.out.println("Process completed successfully");

Formatintervall…Lägga till ramar till ett namngivet intervall

Det är möjligt att lägga till ramar till en cellgrupp istället för bara en enskild cell. Range objektet tillhandahåller en setOutlineBorders metod som tar följande parametrar för att lägga till en ram till cellgruppen:

• borderStyle: ramtypen, vald från CellBorderType  uppräkning.
• borderColor: linjens färg för ramen, vald från Color uppräkning.

Följande exempel visar hur du ställer in en konturram till ett område.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(FormatRanges2.class) + "data/";

// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Adding a new worksheet to the Workbook object
// Obtaining the reference of the newly added worksheet
int sheetIndex = workbook.getWorksheets().add();
Worksheet worksheet = workbook.getWorksheets().get(sheetIndex);

// Accessing the "A1" cell from the worksheet
Cell cell = worksheet.getCells().get("A1");

// Adding some value to the "A1" cell
cell.setValue("Hello World From Aspose");

// Creating a range of cells starting from "A1" cell to 3rd column in a
// row
Range range = worksheet.getCells().createRange("A1:C1");
range.setName("MyRange");

// Adding a thick outline border with the blue line
range.setOutlineBorders(CellBorderType.THICK, Color.getBlue());

// Saving the Excel file
workbook.save(dataDir + "FormatRanges2_out.xls");

// Print message
System.out.println("Process completed successfully");

Följande utmatning skulle genereras efter att ovanstående kod har körts:

Tillämpa stil på celler i ett intervall

Ibland vill du skapa och tillämpa en stil på cellerna i ett Range. För detta kan du iterera över cellerna i intervallet och använda Cell.setStyle metoden för att tillämpa stilen på cellen.

Följande exempel visar hur du tillämpar stilar på celler i ett intervall.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(ConvertCellsAddresstoRangeorCellArea.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Obtaining the reference of the newly added worksheet
int sheetIndex = workbook.getWorksheets().add();
Worksheet worksheet = workbook.getWorksheets().get(sheetIndex);

// Accessing the "A1" cell from the worksheet
Cell cell = worksheet.getCells().get("A1");

// Adding some value to the "A1" cell
cell.setValue("Hello World!");

// Creating a range of cells based on cells Address.
Range range = worksheet.getCells().createRange("A1:F10");

// Specify a Style object for borders.
Style style = cell.getStyle();
// Setting the line style of the top border

style.setBorder(BorderType.TOP_BORDER, CellBorderType.THICK, Color.getBlack());

style.setBorder(BorderType.BOTTOM_BORDER, CellBorderType.THICK, Color.getBlack());

style.setBorder(BorderType.LEFT_BORDER, CellBorderType.THICK, Color.getBlack());

style.setBorder(BorderType.RIGHT_BORDER, CellBorderType.THICK, Color.getBlack());

Iterator cellArray = range.iterator();
while (cellArray.hasNext()) {
	Cell temp = (Cell) cellArray.next();
	// Saving the modified style to the cell.
	temp.setStyle(style);
}

// Saving the Excel file
workbook.save(dataDir + "CCAToROrCArea_out.xls");

Ta bort ett namngivet område

Aspose.Cells tillhandahåller NameCollection.RemoveAt() metoden för att ta bort namnet på intervallen. För att rensa innehållet i intervallet, använd Cells.ClearRange() metoden. Följande exempel visar hur du tar bort ett namngivet intervall med dess innehåll.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(RemoveANamedRange.class) + "data/";

// Instantiate a new Workbook.
Workbook workbook = new Workbook();

// Get all the worksheets in the book.
WorksheetCollection worksheets = workbook.getWorksheets();

// Get the first worksheet in the worksheets collection.
Worksheet worksheet = workbook.getWorksheets().get(0);

// Create a range of cells.
Range range1 = worksheet.getCells().createRange("E12", "I12");

// Name the range.
range1.setName("MyRange");

// Set the outline border to the range.
range1.setOutlineBorder(BorderType.TOP_BORDER, CellBorderType.MEDIUM, Color.fromArgb(0, 0, 128));
range1.setOutlineBorder(BorderType.BOTTOM_BORDER, CellBorderType.MEDIUM, Color.fromArgb(0, 0, 128));
range1.setOutlineBorder(BorderType.LEFT_BORDER, CellBorderType.MEDIUM, Color.fromArgb(0, 0, 128));
range1.setOutlineBorder(BorderType.RIGHT_BORDER, CellBorderType.MEDIUM, Color.fromArgb(0, 0, 128));

// Input some data with some formattings into
// a few cells in the range.
range1.get(0, 0).setValue("Test");
range1.get(0, 4).setValue("123");

// Create another range of cells.
Range range2 = worksheet.getCells().createRange("B3", "F3");

// Name the range.
range2.setName("testrange");

// Copy the first range into second range.
range2.copy(range1);

// Remove the previous named range (range1) with its contents.
worksheet.getCells().clearRange(11, 4, 11, 8);
worksheets.getNames().removeAt(0);

// Save the excel file.
workbook.save(dataDir + "RANRange_out.xls");

// Print message
System.out.println("Process completed successfully");

borderColors