Método Application.SetMatchingField (Project)

Artigo
04/07/2023

Define, em tarefas ou recursos selecionados, o valor do campo que satisfaz os critérios especificados.

Sintaxe

expressão. SetMatchingField (Campo, Valor, CheckField, CheckValue, CheckTest, CheckOperation, CheckField2, CheckValue2, CheckTest2)

expressão Uma variável que representa um Aplicativo objeto.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Field	Obrigatório	String	O nome do campo a ser definido.
Value	Obrigatório	String	O valor com o qual o campo é definido.
CheckField	Obrigatório	String	O nome do campo a ser verificado.
CheckValue	Obrigatório	String	O valor a ser comparado com o valor do campo especificado com CheckField.
CheckTest	Opcional	String	O tipo de comparação feita entre CheckField e CheckValue. O valor padrão é "é igual a". Pode ser uma das cadeias de caracteres de comparação.
CheckOperation	Opcional	String	Como os critérios estabelecidos com CheckField, CheckTest e CheckValue se relacionam com os segundo critérios, se especificados. O argumento CheckOperation pode ser definido como "And" ou "Or". O valor padrão é "And".
CheckField2	Obrigatório	String	O nome do segundo campo a ser verificado.
CheckValue2	Obrigatório	String	O valor com o qual o segundo campo é definido.
CheckTest2	Opcional	Variantes	O tipo de comparação feita entre CheckField2 e CheckValue2. Pode ser uma das mesmas cadeias de caracteres de comparação que CheckTest.

Cadeias de caracteres de comparação

Cadeia de comparação	Descrição
"é igual a"	O valor de CheckField é igual o de CheckValue.
"é diferente de"	O valor de CheckField não é igual ao de CheckValue.
"é maior que"	O valor de CheckField é maior que o de CheckValue.
"é maior ou igual a"	O valor de CheckField é maior ou igual ao de CheckValue.
"é menor que"	O valor de CheckField é menor que o de CheckValue.
"é menor ou igual a"	O valor de CheckField é menor ou igual ao de CheckValue.
"está contido em"	O valor de CheckField está contido em Value.
"não está contido em"	O valor de CheckField não está contido em Value.
"contém"	CheckField contém CheckValue.
"não contém"	CheckField não contém CheckValue.
"contém exatamente"	CheckField contém exatamente CheckValue.

Valor de retorno

Boolean

Exemplo

O exemplo a seguir verifica a igualdade do campo Namede tarefas , altera o valor para New Task Namee, em seguida, altera o nome de volta para o original.

Sub Set_MatchingField() 
 
 Dim T As Task 
 Dim OldName As String 
 
 'Save the task name 
 Set T = ActiveProject.Tasks(3) 
 OldName = T.GetField(pjTaskName) 
 
 ViewApply Name:="&Gantt Chart" 
 'Change the field to "New Task's Name" 
 SetMatchingField Field:="Name", Value:="New Task Name", CheckField:="Name", CheckValue:=OldName, CheckTest:="equals" 
 ' Set the field to the old name 
 SetMatchingField Field:="Name", Value:=OldName, CheckField:="Name", CheckValue:="New Task's Name", CheckTest:="equals" 
End Sub

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.

Compartilhar via