Partager via


Excel.CellPropertiesLoadOptions interface

Représente les propriétés de cellule à charger, lorsqu’elles sont utilisées dans le cadre d’une méthode « range.getCellProperties ».

[ Ensemble d’API : ExcelApi 1.9 ]

Propriétés

address

Spécifie s’il faut charger sur la address propriété .

[ Ensemble d’API : ExcelApi 1.9 ]

addressLocal

Spécifie s’il faut charger sur la addressLocal propriété .

[ Ensemble d’API : ExcelApi 1.9 ]

format

Spécifie s’il faut charger sur la format propriété .

[ Ensemble d’API : ExcelApi 1.9 ]

hidden

Spécifie s’il faut charger sur la hidden propriété .

[ Ensemble d’API : ExcelApi 1.9 ]

hyperlink

Spécifie s’il faut charger sur la hyperlink propriété .

[ Ensemble d’API : ExcelApi 1.9 ]

style

Spécifie s’il faut charger sur la style propriété .

[ Ensemble d’API : ExcelApi 1.9 ]

textRuns

Spécifie s’il faut charger sur la textRuns propriété .

[ Ensemble d’API : RangeTextRun ]

Détails de la propriété

address

Spécifie s’il faut charger sur la address propriété .

[ Ensemble d’API : ExcelApi 1.9 ]

address?: boolean;

Valeur de propriété

boolean

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/cell-properties.yaml

await Excel.run(async (context) => {
    const cell = context.workbook.getActiveCell();

    // Define the cell properties to get by setting the matching LoadOptions to true.
    const propertiesToGet = cell.getCellProperties({
        address: true,
        format: {
            fill: {
                color: true
            },
            font: {
                color: true
            }
        },
        style: true
    });

    // Sync to get the data from the workbook.
    await context.sync();
    const cellProperties = propertiesToGet.value[0][0];
    console.log(
        `Address: ${cellProperties.address}\nStyle: ${cellProperties.style}\nFill Color: ${cellProperties.format.fill.color}\nFont Color: ${cellProperties.format.font.color}`);
});

addressLocal

Spécifie s’il faut charger sur la addressLocal propriété .

[ Ensemble d’API : ExcelApi 1.9 ]

addressLocal?: boolean;

Valeur de propriété

boolean

format

Spécifie s’il faut charger sur la format propriété .

[ Ensemble d’API : ExcelApi 1.9 ]

format?: Excel.CellPropertiesFormatLoadOptions;

Valeur de propriété

hidden

Spécifie s’il faut charger sur la hidden propriété .

[ Ensemble d’API : ExcelApi 1.9 ]

hidden?: boolean;

Valeur de propriété

boolean

Spécifie s’il faut charger sur la hyperlink propriété .

[ Ensemble d’API : ExcelApi 1.9 ]

hyperlink?: boolean;

Valeur de propriété

boolean

style

Spécifie s’il faut charger sur la style propriété .

[ Ensemble d’API : ExcelApi 1.9 ]

style?: boolean;

Valeur de propriété

boolean

textRuns

Spécifie s’il faut charger sur la textRuns propriété .

[ Ensemble d’API : RangeTextRun ]

textRuns?: boolean;

Valeur de propriété

boolean