PowerPoint.ShapeFont class

Especifica se o texto no TextRange está definido para utilizar o atributo Todas as Maiúsculas , o que faz com que as letras minúsculas apareçam como letras maiúsculas. Os valores possíveis são os seguintes:

• true : todo o texto tem o atributo Todas as Maiúsculas .

• false : nenhum dos textos tem o atributo Todas as Maiúsculas .

• null : devolvido se algum, mas não todos, do texto tiver o atributo Todas as Maiúsculas .

allCaps: boolean | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Especifica se o texto no TextRange está definido como negrito. Os valores possíveis são os seguintes:

• true : todo o texto está a negrito.

• false : nenhum dos textos está a negrito.

• null : devolvido se algum, mas não todos, do texto estiver a negrito.

bold: boolean | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

Especifica a representação do código de cores HTML da cor do texto (por exemplo, "#FF0000" representa vermelho). Devolve null se o TextRange contém fragmentos de texto com cores diferentes.

color: string | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/text/get-set-textrange.yaml

// Sets the color of the selected text range to green.
await PowerPoint.run(async (context) => {
  const textRange: PowerPoint.TextRange = context.presentation.getSelectedTextRange();
  textRange.font.color = "green";
  await context.sync();
});

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

context: RequestContext;

Valor da propriedade

Especifica se o texto no TextRange está definido para utilizar o atributo Rasurado duplo . Os valores possíveis são os seguintes:

• true : todo o texto tem o atributo Rasurado duplo .

• false : nenhum dos textos tem o atributo Rasurado duplo .

• null : devolvido se algum, mas não todos, do texto tiver o atributo Rasurado duplo .

doubleStrikethrough: boolean | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Especifica se o texto no TextRange está definido como itálico. Os valores possíveis são os seguintes:

• true : todo o texto está em itálico.

• false : nenhum dos textos está em itálico.

• null : devolvido se algum, mas não todos, do texto estiver em itálico.

italic: boolean | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

Especifica o nome do tipo de letra (por exemplo, "Calibri"). Se o texto for um Script Complexo ou um idioma asiático, este é o nome do tipo de letra correspondente; caso contrário, é o nome do tipo de letra latino. Devolve null se o TextRange contém fragmentos de texto com nomes de tipos de letra diferentes.

name: string | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

Especifica o tamanho do tipo de letra em pontos (por exemplo, 11). Devolve null se o TextRange contém fragmentos de texto com tamanhos de tipo de letra diferentes.

size: number | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

Especifica se o texto no TextRange está definido para utilizar o atributo Maiúsculas Pequenas , o que faz com que as letras minúsculas apareçam como letras maiúsculas pequenas. Os valores possíveis são os seguintes:

• true : todo o texto tem o atributo Maiúsculas Pequenas .

• false : nenhum dos textos tem o atributo Maiúsculas Pequenas .

• null : devolvido se algum, mas não todos, do texto tiver o atributo Maiúsculas Pequenas .

smallCaps: boolean | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Especifica se o texto no TextRange está definido para utilizar o atributo Rasurado . Os valores possíveis são os seguintes:

• true : todo o texto tem o atributo Rasurado .

• false : nenhum dos textos tem o atributo Rasurado .

• null : devolvido se algum, mas não todos, do texto tiver o atributo Rasurado .

strikethrough: boolean | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Especifica se o texto no TextRange está definido para utilizar o atributo Inferior à Linha . Os valores possíveis são os seguintes:

• true : todo o texto tem o atributo Inferior à Linha .

• false : nenhum dos textos tem o atributo Inferior à Linha .

• null : devolvido se algum, mas não todos, do texto tiver o atributo Inferior à Linha .

subscript: boolean | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Especifica se o texto no TextRange está definido para utilizar o atributo Superior à Linha . Os valores possíveis são os seguintes:

• true : todo o texto tem o atributo Superior à Linha .

• false : nenhum dos textos tem o atributo Superior à Linha .

• null : devolvido se algum, mas não todos, do texto tiver o atributo Superior à Linha .

superscript: boolean | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO) ]

Especifica o tipo de sublinhado aplicado ao tipo de letra. Devolve null se o TextRange contém fragmentos de texto com estilos de sublinhado diferentes. Consulte PowerPoint.ShapeFontUnderlineStyle para obter detalhes.

underline: PowerPoint.ShapeFontUnderlineStyle | "None" | "Single" | "Double" | "Heavy" | "Dotted" | "DottedHeavy" | "Dash" | "DashHeavy" | "DashLong" | "DashLongHeavy" | "DotDash" | "DotDashHeavy" | "DotDotDash" | "DotDotDashHeavy" | "Wavy" | "WavyHeavy" | "WavyDouble" | null;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(options?: PowerPoint.Interfaces.ShapeFontLoadOptions): PowerPoint.ShapeFont;

Parâmetros

Retornos

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNames?: string | string[]): PowerPoint.ShapeFont;

Parâmetros

Retornos

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): PowerPoint.ShapeFont;

Parâmetros

Retornos

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto original PowerPoint.ShapeFont é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como PowerPoint.Interfaces.ShapeFontData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

toJSON(): PowerPoint.Interfaces.ShapeFontData;

Retornos