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"
Remarques
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour