Excel.CellPropertiesFont interface
Représente les format.font
propriétés de getCellProperties
, getRowProperties
et getColumnProperties
, ou le paramètre d’entrée format.font
de setCellProperties
, setRowProperties
et .setColumnProperties
Remarques
[ Ensemble d’API : ExcelApi 1.9 ]
Propriétés
bold | Représente la |
color | Représente la |
italic | Représente la |
name | Représente la |
size | Représente la |
strikethrough | Représente la |
subscript | Représente la |
superscript | Représente la |
tint |
Représente la |
underline | Représente la |
Détails de la propriété
bold
Représente la format.font.bold
propriété.
bold?: boolean;
Valeur de propriété
boolean
Remarques
color
Représente la format.font.color
propriété.
color?: string;
Valeur de propriété
string
Remarques
[ Ensemble d’API : ExcelApi 1.9 ]
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 sheet = context.workbook.worksheets.getActiveWorksheet();
// Creating the SettableCellProperties objects to use for the range.
// In your add-in, these should be created once, outside the function.
const topHeaderProps: Excel.SettableCellProperties = {
// The style property takes a string matching the name of an Excel style.
// Built-in style names are listed in the `BuiltInStyle` enum.
// Note that a style will overwrite any formatting,
// so do not use the format property with the style property.
style: "Heading1"
};
const headerProps: Excel.SettableCellProperties = {
// Any subproperties of format that are not set will not be changed when these cell properties are set.
format: {
fill: {
color: "Blue"
},
font: {
color: "White",
bold: true
}
}
};
const nonApplicableProps: Excel.SettableCellProperties = {
format: {
fill: {
pattern: Excel.FillPattern.gray25
},
font: {
color: "Gray",
italic: true
}
}
};
const matchupScoreProps: Excel.SettableCellProperties = {
format: {
borders: {
bottom: {
style: Excel.BorderLineStyle.continuous
},
left: {
style: Excel.BorderLineStyle.continuous
},
right: {
style: Excel.BorderLineStyle.continuous
},
top: {
style: Excel.BorderLineStyle.continuous
}
}
}
};
const range = sheet.getRange("A1:E5");
// You can use empty JSON objects to avoid changing a cell's properties.
range.setCellProperties([
[topHeaderProps, {}, {}, {}, {}],
[{}, {}, headerProps, headerProps, headerProps],
[{}, headerProps, nonApplicableProps, matchupScoreProps, matchupScoreProps],
[{}, headerProps, matchupScoreProps, nonApplicableProps, matchupScoreProps],
[{}, headerProps, matchupScoreProps, matchupScoreProps, nonApplicableProps]
]);
sheet.getUsedRange().format.autofitColumns();
await context.sync();
});
italic
Représente la format.font.italic
propriété.
italic?: boolean;
Valeur de propriété
boolean
Remarques
name
Représente la format.font.name
propriété.
name?: string;
Valeur de propriété
string
Remarques
size
Représente la format.font.size
propriété.
size?: number;
Valeur de propriété
number
Remarques
strikethrough
Représente la format.font.strikethrough
propriété.
strikethrough?: boolean;
Valeur de propriété
boolean
Remarques
subscript
Représente la format.font.subscript
propriété.
subscript?: boolean;
Valeur de propriété
boolean
Remarques
superscript
Représente la format.font.superscript
propriété.
superscript?: boolean;
Valeur de propriété
boolean
Remarques
tintAndShade
Représente la format.font.tintAndShade
propriété.
tintAndShade?: number;
Valeur de propriété
number
Remarques
underline
Représente la format.font.underline
propriété.
underline?: Excel.RangeUnderlineStyle | "None" | "Single" | "Double" | "SingleAccountant" | "DoubleAccountant";
Valeur de propriété
Excel.RangeUnderlineStyle | "None" | "Single" | "Double" | "SingleAccountant" | "DoubleAccountant"