Table of contents
TOC
Recolher sumário
Expandir sumário

Método Graphicitem. (Visio)GraphicItem.SetExpression Method (Visio)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

Define o valor da cadeia de caracteres expressão que faz parte de uma regra de object?s GraphicItem , em relação a quais forma (propriedades personalizadas) de dados são avaliados.Sets the value of the expression string that is part of a GraphicItem object?s rule, against which shape data (custom properties) are evaluated.

Observação Este objeto do Visio ou membro está disponível somente para usuários licenciados do Visio Professional 2013.Note This Visio object or member is available only to licensed users of Visio Professional 2013.

SintaxeSyntax

expressão . SetExpression ( Campo , expressão )expression . SetExpression( Field , Expression )

expressão Uma expressão que retorna um objeto GraphicItem .expression An expression that returns a GraphicItem object.

ParâmetrosParameters

NomeNameObrigatório/opcionalRequired/OptionalTipo de dadosData TypeDescriçãoDescription
FieldFieldObrigatórioRequiredVisGraphicFieldVisGraphicFieldO rótulo ou uma fórmula do campo (coluna) de dados primário atribuído para o GraphicItem . Consulte comentários para os valores possíveis.The label or formula of the primary data field (column) assigned to the GraphicItem . See Remarks for possible values.
ExpressãoExpressionObrigatórioRequiredStringStringA expressão ShapeSheet associada ao parâmetro Field.The ShapeSheet expression associated with the Field parameter.

Valor de retornoReturn Value

NadaNothing

ComentáriosRemarks

O parâmetro Field deve ser um dos seguintes valores da enumeração VisGraphicField , declarada na biblioteca de tipos do Microsoft Visio.The Field parameter should be one of the following values from the VisGraphicField enumeration, which is declared in the Microsoft Visio Type Library.

ConstanteConstantValorValueDescriçãoDescription
visGraphicPropertyLabelvisGraphicPropertyLabel11O rótulo de um item de dados da forma.The label of a shape data item.
visGraphicExpressionvisGraphicExpression22A fórmula do ShapeSheet de um item de dados da forma.The ShapeSheet formula of a shape data item.

Quando você passar o SetExpression rótulo de um item de forma-dados de método (ou seja, quando você passar visGraphicPropertyLabel para o parâmetro de campo), você deve colocar o rótulo entre chaves ({}). Por exemplo, se você deseja passar o nome do item de dados da forma "Custo", você deve gravá-lo semelhante a esta: {custo}.When you pass the SetExpression method a shape-data-item label (that is, when you pass visGraphicPropertyLabel for the Field parameter), you must enclose the label within curly braces ({}). For example, if you want to pass the name of the "Cost" shape-data item, you must write it like this: {Cost}.

Você pode referenciar os dados de uma forma diferente daquela à qual o gráfico de dados é aplicado, passando o nome da forma seguido de um ponto de exclamação (!) e, em seguida, o nome do campo. No exemplo a seguir, para se referir à largura da forma Ellipse.34, você pode usar esta sintaxe:You can reference the shape data of a shape other than the one to which the data graphic is applied by passing the name of the shape followed by an exclamation point (!) and then the name of the field. For example, in the example shown below, to refer to the width of the shape named Ellipse.34, you could use the following syntax:

vsoGraphicItem.SetExpression visGraphicExpression, "Ellipse.34!Width"

Antes de editar um item de gráfico, incluindo a definição de sua cadeia de caracteres de expressão, você deve usar o método de Master para abrir para edição de uma cópia do mestre de gráfico de dados cuja coleção GraphicItems item gráfico pertence. Depois de ter definido a expressão do item gráfico e feito qualquer outras edições que você deseja fazer, use o método Master.Close para confirmar as alterações.Before you can edit a graphic item, including setting its expression string, you must use the Master.Open method to open for editing a copy of the data graphic master whose GraphicItems collection the graphic item belongs to. After you have set the expression of the graphic item and made whatever other edits you want to make, use the Master.Close method to commit changes.

ExemploExample

Os seguintes Microsoft Visual Basic for Applications (VBA) macro mostra como usar o método SetExpression para definir o valor da cadeia de caracteres de expressão para um item de gráfico de dados. Ele abre uma cópia do objeto Master do tipo visTypeDataGraphic (geralmente chamado de um gráfico de dados) denominada "Gráfico de dados" e, em seguida, define a expressão do primeiro item gráfico na coleção GraphicItems de para exibir o gráfico de dados a largura de qualquer forma à qual o gráfico de dados é aplicado.The following Microsoft Visual Basic for Applications (VBA) macro shows how to use the SetExpression method to set the value of the expression string for a data graphic item. It opens a copy of the Master object of type visTypeDataGraphic (commonly called a data graphic) named "Data Graphic," and then sets the expression of the first graphic item in the GraphicItems collection of the data graphic to display the width of any shape to which the data graphic is applied.

Observação Você pode determinar o nome de um mestre de gráfico de dados existente, mova o mouse sobre o mestre no painel de tarefas de Gráficos de dados na interface de usuário do Visio.Note You can determine the name of an existing data graphic master by moving your mouse over the master in the Data Graphics task pane in the Visio user interface.

Em seguida, ele fecha o mestre e usa o método GetExpression para obter a expressão aplicada principalmente recentemente para o item de gráfico. Finalmente, imprime o tipo de campo e o valor da expressão na janela Immediate .Then it closes the master and uses the GetExpression method to get the mostly recently applied expression for the graphic item. Finally, it prints the field type and the value of the expression in the Immediate window.

A macro supõe que um gráfico de dados chamado "Gráfico de dados" existe no documento atual. Para obter mais informações sobre como adicionar um mestre de gráfico de dados à coleção Masters do documento atual, consulte Masters .The macro assumes that a data graphic named "Data Graphic" exists in the current document. For more information about adding a data graphic master to the Masters collection of the current document, see Masters.AddEx .

Public Sub SetExpression_Example() 

    Dim vsoMaster As Visio.Master 
    Dim vsoMasterCopy As Visio.Master 
    Dim vsoGraphicItem As Visio.GraphicItem 
    Dim strExpression As String 
    Dim fieldType As VisGraphicField 

    Set vsoMaster = Visio.ActiveDocument.Masters("Data Graphic") 
    Set vsoMasterCopy = vsoMaster.Open 
    Set vsoGraphicItem = vsoMasterCopy.GraphicItems(1) 

    vsoGraphicItem.SetExpression visGraphicExpression, "Width" 
    vsoMasterCopy.Close 

    vsoMaster.GraphicItems(1).GetExpression fieldType, strExpression 

    Debug.Print "Field type is "; fieldType 
    Debug.Print "Expression is "; strExpression 

End Sub
© 2018 Microsoft