Método FreeformBuilder.AddNodes (Publisher)
Insere um novo segmento no final da forma livre que está sendo criado e adiciona os nós que definem o segmento.
Use esse método quantas vezes quiser adicionar nós à forma livre que você está criando. Ao concluir a adição de nós, use o método ConvertToShape para criar a forma livre que você acabou de definir.
Sintaxe
expressão. AddNodes (SegmentType, EditingType, X1, Y1, X2, Y2, X3, Y3)
Expressão Uma variável que representa um objeto FreeformBuilder .
Parâmetros
Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
---|---|---|---|
SegmentType | Obrigatório | MsoSegmentType | O tipo de segmento a ser adicionado. Pode ser msoSegmentCurve ou msoSegmentLine. |
EditingType | Obrigatório | MsoEditingType | O tipo de edição do novo nó. Pode ser msoEditingAuto ou msoEditingCorner. Se SegmentType for msoSegmentLine, EditingType deverá ser msoEditingAuto; caso contrário, ocorrerá um erro. |
X1 | Obrigatório | Variantes | Se o EditingType do novo segmento for msoEditingAuto, esse argumento especificará a distância horizontal do canto superior esquerdo da página até o ponto de extremidade do novo segmento. Se o EditingType do novo nó for msoEditingCorner, esse argumento especificará a distância horizontal do canto superior esquerdo da página até o primeiro ponto de controle do novo segmento. |
Y1 | Obrigatório | Variantes | Se o EditingType do novo segmento for msoEditingAuto, esse argumento especificará a distância vertical do canto superior esquerdo da página até o ponto de extremidade do novo segmento. Se o EditingType do novo nó for msoEditingCorner, esse argumento especificará a distância vertical do canto superior esquerdo da página até o primeiro ponto de controle do novo segmento. |
X2 | Opcional | Variantes | Se o EditingType do novo segmento for msoEditingCorner, esse argumento especificará a distância horizontal do canto superior esquerdo da página até o segundo ponto de controle do novo segmento. Se o EditingType do novo segmento for msoEditingAuto, não especifique um valor para esse argumento. |
Y2 | Opcional | Variantes | Se o EditingType do novo segmento for msoEditingCorner, esse argumento especificará a distância vertical do canto superior esquerdo da página até o segundo ponto de controle do novo segmento. Se o EditingType do novo segmento for msoEditingAuto, não especifique um valor para esse argumento. |
X3 | Opcional | Variantes | Se o EditingType do novo segmento for msoEditingCorner, esse argumento especificará a distância horizontal do canto superior esquerdo da página até o ponto de extremidade do novo segmento. Se o EditingType do novo segmento for msoEditingAuto, não especifique um valor para esse argumento. |
Y3 | Opcional | Variantes | Se o EditingType do novo segmento for msoEditingAuto, esse argumento especificará a distância vertical do canto superior esquerdo da página até o ponto de extremidade do novo segmento. Se o EditingType do novo segmento for msoEditingAuto, não especifique um valor para esse argumento. |
Comentários
Para os argumentos X1, Y1, X2, Y2, X3 e Y3 , os valores numéricos são avaliados em pontos; cadeias de caracteres podem estar em todas as unidades com suporte do Microsoft Publisher (por exemplo, "2.5 in").
Para adicionar nós a uma forma livre depois de criada, use o método Insert da coleção ShapeNodes .
Exemplo
Este exemplo adiciona uma forma livre com quatro vértices à primeira página da publicação ativa.
' Add a new freeform object.
With ActiveDocument.Pages(1).Shapes _
.BuildFreeform(EditingType:=msoEditingCorner, _
X1:=100, Y1:=100)
' Add three more nodes and close the polygon.
.AddNodes SegmentType:=msoSegmentCurve, _
EditingType:=msoEditingCorner, _
X1:=200, Y1:=200, X2:=225, Y2:=250, X3:=250, Y3:=200
.AddNodes SegmentType:=msoSegmentCurve, _
EditingType:=msoEditingAuto, X1:=200, Y1:=100
.AddNodes SegmentType:=msoSegmentLine, _
EditingType:=msoEditingAuto, X1:=150, Y1:=50
.AddNodes SegmentType:=msoSegmentLine, _
EditingType:=msoEditingAuto, X1:=100, Y1:=100
' Convert the polygon to a Shape object.
.ConvertToShape
End With
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.