PowerPoint.TableCellProperties interface
Représente les propriétés de cellule de tableau à mettre à jour.
Remarques
[ Ensemble d’API : PowerPointApi 1.8 ]
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/add-modify-tables.yaml
// Specifies the font formatting and fill colors of the cells in a table.
await PowerPoint.run(async (context) => {
const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;
// Add a table, specifying font formatting and fill colors.
shapes.addTable(3, 4, {
values: [
["A", "BB", "CCC", "DDDD"],
["E", "FF", "GGG", "HHHH"],
["1", "12", "123", "1234"]
],
specificCellProperties: [
[
{ fill: { color: "red" }, font: { color: "yellow", name: "Calibri" } },
{ fill: { color: "#0048ba" }, font: { color: "yellow", name: "Coolvetica" } },
{ fill: { color: "red" }, font: { color: "yellow", italic: true } },
{ fill: { color: "red" }, font: { color: "#9966cc", strikethrough: true } }
],
[
{ fill: { color: "#fbceb1" }, font: { color: "yellow", doubleStrikethrough: true } },
{ fill: { color: "red" }, font: { color: "yellow", subscript: true } },
{ fill: { color: "#0048ba" }, font: { color: "yellow", superscript: true } },
{ fill: { color: "red" }, font: { color: "yellow" } }
],
[
{ fill: { color: "red" }, font: { color: "#b0bf1a" } },
{ fill: { color: "#9966cc" }, font: { color: "yellow" } },
{ fill: { color: "#b0bf1a" }, font: { color: "yellow" } },
{ fill: { color: "red" }, font: { color: "#fbceb1" } }
]
]
});
await context.sync();
});
Propriétés
| borders | Spécifie la mise en forme de bordure de la cellule du tableau. |
| fill | Spécifie la mise en forme de remplissage de la cellule du tableau. |
| font | Spécifie la mise en forme de police de la cellule du tableau. |
| horizontal |
Spécifie l’alignement horizontal du texte dans la cellule du tableau. |
| indent |
Spécifie le niveau de retrait du texte dans la cellule du tableau. |
| margins | Spécifie les paramètres de marge dans la cellule du tableau. |
| text | Spécifie le contenu du texte de la cellule du tableau. Si une partie du texte nécessite une mise en forme différente, utilisez la propriété à la |
| text |
Spécifie le contenu de la cellule de tableau sous la forme d’un tableau d’objets PowerPoint.TextRun . Chaque |
| vertical |
Spécifie l’alignement vertical du texte dans la cellule du tableau. |
Détails de la propriété
borders
Spécifie la mise en forme de bordure de la cellule du tableau.
borders?: PowerPoint.TableCellBorders;
Valeur de propriété
Remarques
[ Ensemble d’API : PowerPointApi 1.8 ]
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/add-modify-tables.yaml
// Specifies a table's borders.
await PowerPoint.run(async (context) => {
const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;
// Add a table, specifying border styles.
shapes.addTable(3, 4, {
values: [
["A", "BB", "CCC", "DDDD"],
["E", "FF", "GGG", "HHHH"],
["1", "12", "123", "1234"]
],
uniformCellProperties: {
borders: {
left: { color: "blue", dashStyle: PowerPoint.ShapeLineDashStyle.solid, weight: 4 },
right: { color: "blue", dashStyle: PowerPoint.ShapeLineDashStyle.solid, weight: 4 },
top: { color: "red", dashStyle: PowerPoint.ShapeLineDashStyle.longDashDotDot, weight: 2 },
bottom: { color: "red", dashStyle: PowerPoint.ShapeLineDashStyle.longDashDotDot, weight: 2 }
}
}
});
await context.sync();
});
fill
Spécifie la mise en forme de remplissage de la cellule du tableau.
fill?: PowerPoint.FillProperties;
Valeur de propriété
Remarques
[ Ensemble d’API : PowerPointApi 1.8 ]
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/add-modify-tables.yaml
// Specifies the font formatting and fill colors of the cells in a table.
await PowerPoint.run(async (context) => {
const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;
// Add a table, specifying font formatting and fill colors.
shapes.addTable(3, 4, {
values: [
["A", "BB", "CCC", "DDDD"],
["E", "FF", "GGG", "HHHH"],
["1", "12", "123", "1234"]
],
specificCellProperties: [
[
{ fill: { color: "red" }, font: { color: "yellow", name: "Calibri" } },
{ fill: { color: "#0048ba" }, font: { color: "yellow", name: "Coolvetica" } },
{ fill: { color: "red" }, font: { color: "yellow", italic: true } },
{ fill: { color: "red" }, font: { color: "#9966cc", strikethrough: true } }
],
[
{ fill: { color: "#fbceb1" }, font: { color: "yellow", doubleStrikethrough: true } },
{ fill: { color: "red" }, font: { color: "yellow", subscript: true } },
{ fill: { color: "#0048ba" }, font: { color: "yellow", superscript: true } },
{ fill: { color: "red" }, font: { color: "yellow" } }
],
[
{ fill: { color: "red" }, font: { color: "#b0bf1a" } },
{ fill: { color: "#9966cc" }, font: { color: "yellow" } },
{ fill: { color: "#b0bf1a" }, font: { color: "yellow" } },
{ fill: { color: "red" }, font: { color: "#fbceb1" } }
]
]
});
await context.sync();
});
font
Spécifie la mise en forme de police de la cellule du tableau.
font?: PowerPoint.FontProperties;
Valeur de propriété
Remarques
[ Ensemble d’API : PowerPointApi 1.8 ]
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/add-modify-tables.yaml
// Specifies the font formatting and fill colors of the cells in a table.
await PowerPoint.run(async (context) => {
const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;
// Add a table, specifying font formatting and fill colors.
shapes.addTable(3, 4, {
values: [
["A", "BB", "CCC", "DDDD"],
["E", "FF", "GGG", "HHHH"],
["1", "12", "123", "1234"]
],
specificCellProperties: [
[
{ fill: { color: "red" }, font: { color: "yellow", name: "Calibri" } },
{ fill: { color: "#0048ba" }, font: { color: "yellow", name: "Coolvetica" } },
{ fill: { color: "red" }, font: { color: "yellow", italic: true } },
{ fill: { color: "red" }, font: { color: "#9966cc", strikethrough: true } }
],
[
{ fill: { color: "#fbceb1" }, font: { color: "yellow", doubleStrikethrough: true } },
{ fill: { color: "red" }, font: { color: "yellow", subscript: true } },
{ fill: { color: "#0048ba" }, font: { color: "yellow", superscript: true } },
{ fill: { color: "red" }, font: { color: "yellow" } }
],
[
{ fill: { color: "red" }, font: { color: "#b0bf1a" } },
{ fill: { color: "#9966cc" }, font: { color: "yellow" } },
{ fill: { color: "#b0bf1a" }, font: { color: "yellow" } },
{ fill: { color: "red" }, font: { color: "#fbceb1" } }
]
]
});
await context.sync();
});
horizontalAlignment
Spécifie l’alignement horizontal du texte dans la cellule du tableau.
horizontalAlignment?: PowerPoint.ParagraphHorizontalAlignment | "Left" | "Center" | "Right" | "Justify" | "JustifyLow" | "Distributed" | "ThaiDistributed" | undefined;
Valeur de propriété
PowerPoint.ParagraphHorizontalAlignment | "Left" | "Center" | "Right" | "Justify" | "JustifyLow" | "Distributed" | "ThaiDistributed" | undefined
Remarques
[ Ensemble d’API : PowerPointApi 1.8 ]
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/add-modify-tables.yaml
// Specifies the horizontal and vertical alignments of the cells in a table.
await PowerPoint.run(async (context) => {
const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;
// Add a table, specifying horizontal and vertical alignment.
shapes.addTable(3, 4, {
values: [
["A", "BB", "CCC", "DDDD"],
["E", "FF", "GGG", "HHHH"],
["1", "12", "123", "1234"]
],
uniformCellProperties: {
horizontalAlignment: PowerPoint.ParagraphHorizontalAlignment.justify,
verticalAlignment: PowerPoint.TextVerticalAlignment.middle
}
});
await context.sync();
});
indentLevel
Spécifie le niveau de retrait du texte dans la cellule du tableau.
indentLevel?: number | undefined;
Valeur de propriété
number | undefined
Remarques
[ Ensemble d’API : PowerPointApi 1.8 ]
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/add-modify-tables.yaml
// Specifying the indents for a table.
await PowerPoint.run(async (context) => {
const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;
// Add a table, specifying the indent level for cells.
shapes.addTable(3, 4, {
values: [
["A", "BB", "CCC", "DDDD"],
["E", "FF", "GGG", "HHHH"],
["1", "12", "123", "1234"]
],
specificCellProperties: [
[{ indentLevel: 0 }, { indentLevel: 1 }, { indentLevel: 2 }, { indentLevel: 3 }],
[{ indentLevel: 0 }, { indentLevel: 1 }, { indentLevel: 2 }, { indentLevel: 3 }],
[{ indentLevel: 0 }, { indentLevel: 1 }, { indentLevel: 2 }, { indentLevel: 3 }]
]
});
await context.sync();
});
margins
Spécifie les paramètres de marge dans la cellule du tableau.
margins?: PowerPoint.TableCellMargins;
Valeur de propriété
Remarques
text
Spécifie le contenu du texte de la cellule du tableau.
Si une partie du texte nécessite une mise en forme différente, utilisez la propriété à la textRuns place.
text?: string;
Valeur de propriété
string
Remarques
textRuns
Spécifie le contenu de la cellule de tableau sous la forme d’un tableau d’objets PowerPoint.TextRun . Chaque TextRun objet représente une séquence d’un ou plusieurs caractères qui partagent les mêmes attributs de police.
textRuns?: PowerPoint.TextRun[];
Valeur de propriété
Remarques
[ Ensemble d’API : PowerPointApi 1.8 ]
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/add-modify-tables.yaml
// Specifies the text runs of the cells in a table.
await PowerPoint.run(async (context) => {
const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;
// Add a table, specifying text runs.
shapes.addTable(3, 4, {
specificCellProperties: [
[
{ text: "Title text", font: { bold: true } },
{ text: "Title text", font: { bold: true } },
{ text: "Title text", font: { bold: true } },
{ text: "Title text", font: { bold: true } }
],
[
{ text: "Bold text", font: { bold: true } },
{
textRuns: [
{ text: "Text runs with " },
{ text: "Underlined text", font: { underline: PowerPoint.ShapeFontUnderlineStyle.double } },
{ text: " and plain text" }
]
},
{ text: "Italicized text", font: { italic: true } },
{ text: "Plain text" }
],
[
{ text: "Bold text", font: { bold: true } },
{ text: "Underlined text", font: { underline: PowerPoint.ShapeFontUnderlineStyle.dotted } },
{
font: { bold: true },
textRuns: [
{ text: "Text runs with " },
{ text: "italicized text", font: { italic: true } },
{ text: " and (inherited) bold text" }
]
},
{ text: "Italicized text", font: { italic: true } }
]
]
});
await context.sync();
});
verticalAlignment
Spécifie l’alignement vertical du texte dans la cellule du tableau.
verticalAlignment?: PowerPoint.TextVerticalAlignment | "Top" | "Middle" | "Bottom" | "TopCentered" | "MiddleCentered" | "BottomCentered" | undefined;
Valeur de propriété
PowerPoint.TextVerticalAlignment | "Top" | "Middle" | "Bottom" | "TopCentered" | "MiddleCentered" | "BottomCentered" | undefined
Remarques
[ Ensemble d’API : PowerPointApi 1.8 ]
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/add-modify-tables.yaml
// Specifies the horizontal and vertical alignments of the cells in a table.
await PowerPoint.run(async (context) => {
const shapes = context.presentation.getSelectedSlides().getItemAt(0).shapes;
// Add a table, specifying horizontal and vertical alignment.
shapes.addTable(3, 4, {
values: [
["A", "BB", "CCC", "DDDD"],
["E", "FF", "GGG", "HHHH"],
["1", "12", "123", "1234"]
],
uniformCellProperties: {
horizontalAlignment: PowerPoint.ParagraphHorizontalAlignment.justify,
verticalAlignment: PowerPoint.TextVerticalAlignment.middle
}
});
await context.sync();
});