Compartilhar via


Visio.Shape class

Representa a classe Shape.

Extends

Comentários

[ Conjunto de API: 1.1 ]

Propriedades

comments

Retorna a Coleção de Comentários.

context

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

hyperlinks

Retorna a coleção de Hiperlinks para um objeto Forma.

id

Identificador da forma.

name

Nome da Shape.

select

Retorna verdadeiro, se a forma estiver selecionada. O usuário pode definir como verdadeiro para selecionar a forma explicitamente.

shapeDataItems

Retorna a Seção de Dados da Shape.

subShapes

Obtém a Coleção SubShape.

text

Texto da forma.

view

Retorna a visualização da forma.

Métodos

getAbsoluteBounds()

Devolve o objeto AbsoluteBoundingBox que especifica a caixa delimitadora absoluta da forma.

getBounds()

Retorna o objeto BoundingBox que especifica a caixa delimitadora da forma.

load(options)

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

load(propertyNames)

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

load(propertyNamesAndPaths)

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

set(properties, options)

Define várias propriedades de um objeto ao mesmo tempo. Pode transmitir um objeto simples com as propriedades adequadas ou outro objeto de API do mesmo tipo.

set(properties)

Define várias propriedades no objeto ao mesmo tempo, com base num objeto carregado existente.

toJSON()

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 Visio.Shape original é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Visio.Interfaces.ShapeData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

Detalhes da propriedade

comments

Retorna a Coleção de Comentários.

readonly comments: Visio.CommentCollection;

Valor da propriedade

Comentários

[ Conjunto de API: 1.1 ]

context

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

Retorna a coleção de Hiperlinks para um objeto Forma.

readonly hyperlinks: Visio.HyperlinkCollection;

Valor da propriedade

Comentários

[ Conjunto de API: 1.1 ]

id

Identificador da forma.

readonly id: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: 1.1 ]

name

Nome da Shape.

readonly name: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: 1.1 ]

select

Retorna verdadeiro, se a forma estiver selecionada. O usuário pode definir como verdadeiro para selecionar a forma explicitamente.

select: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: 1.1 ]

shapeDataItems

Retorna a Seção de Dados da Shape.

readonly shapeDataItems: Visio.ShapeDataItemCollection;

Valor da propriedade

Comentários

[ Conjunto de API: 1.1 ]

subShapes

Obtém a Coleção SubShape.

readonly subShapes: Visio.ShapeCollection;

Valor da propriedade

Comentários

[ Conjunto de API: 1.1 ]

text

Texto da forma.

readonly text: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: 1.1 ]

view

Retorna a visualização da forma.

readonly view: Visio.ShapeView;

Valor da propriedade

Comentários

[ Conjunto de API: 1.1 ]

Detalhes do método

getAbsoluteBounds()

Devolve o objeto AbsoluteBoundingBox que especifica a caixa delimitadora absoluta da forma.

getAbsoluteBounds(): OfficeExtension.ClientResult<Visio.BoundingBox>;

Retornos

Comentários

[ Conjunto de API: 1.1 ]

getBounds()

Retorna o objeto BoundingBox que especifica a caixa delimitadora da forma.

getBounds(): OfficeExtension.ClientResult<Visio.BoundingBox>;

Retornos

Comentários

[ Conjunto de API: 1.1 ]

load(options)

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

load(options?: Visio.Interfaces.ShapeLoadOptions): Visio.Shape;

Parâmetros

options
Visio.Interfaces.ShapeLoadOptions

Fornece opções para as propriedades do objeto a carregar.

Retornos

load(propertyNames)

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[]): Visio.Shape;

Parâmetros

propertyNames

string | string[]

Uma cadeia delimitada por vírgulas ou uma matriz de cadeias que especificam as propriedades a carregar.

Retornos

Exemplos

Visio.run(session, function (ctx) {
    const activePage = ctx.document.getActivePage();
    const shapeName = "Sample Name";
    const shape = activePage.shapes.getItem(shapeName);
    shape.load(["name", "id", "text", "select"]);
    return ctx.sync().then(function () {
        console.log(shape.name);
        console.log(shape.id);
        console.log(shape.text);
        console.log(shape.select);
    });
}).catch(function(error) {
    console.log("Error: " + error);
    if (error instanceof OfficeExtension.Error) {
        console.log("Debug info: " + JSON.stringify(error.debugInfo));
    }
});
Visio.run(session, function (ctx) {
    const activePage = ctx.document.getActivePage();
    const shape = activePage.shapes.getItem(0);
    shape.view.highlight = { color: "#E7E7E7", width: 100 };
    return ctx.sync();
}).catch(function(error) {
    console.log("Error: " + error);
    if (error instanceof OfficeExtension.Error) {
        console.log("Debug info: " + JSON.stringify(error.debugInfo));
    }
});

load(propertyNamesAndPaths)

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;
        }): Visio.Shape;

Parâmetros

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select é uma cadeia delimitada por vírgulas que especifica as propriedades a carregar e propertyNamesAndPaths.expand é uma cadeia delimitada por vírgulas que especifica as propriedades de navegação a carregar.

Retornos

set(properties, options)

Define várias propriedades de um objeto ao mesmo tempo. Pode transmitir um objeto simples com as propriedades adequadas ou outro objeto de API do mesmo tipo.

set(properties: Interfaces.ShapeUpdateData, options?: OfficeExtension.UpdateOptions): void;

Parâmetros

properties
Visio.Interfaces.ShapeUpdateData

Um objeto JavaScript com propriedades que são estruturadas isomorfoticamente para as propriedades do objeto no qual o método é chamado.

options
OfficeExtension.UpdateOptions

Fornece uma opção para suprimir erros se o objeto de propriedades tentar definir quaisquer propriedades só de leitura.

Retornos

void

set(properties)

Define várias propriedades no objeto ao mesmo tempo, com base num objeto carregado existente.

set(properties: Visio.Shape): void;

Parâmetros

properties
Visio.Shape

Retornos

void

toJSON()

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 Visio.Shape original é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Visio.Interfaces.ShapeData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

toJSON(): Visio.Interfaces.ShapeData;

Retornos