Pode utilizar as funções DVar e DVarP para estimar o desvio de um conjunto de valores num conjunto de registos especificado (um domínio (domínio: conjunto de registos definido por uma tabela, consulta ou expressão SQL. As funções de agregação de domínio devolvem informações estatísticas sobre um domínio específico ou um conjunto de registos.)). Utilize as funções DVar e DVarP num módulo do Visual Basic for Applications (VBA), numa macro (macro: acção ou conjunto de acções que podem ser utilizadas para automatizar tarefas. As macros são gravadas na linguagem de programação Visual Basic for Applications.), numa expressão de consulta ou num controlo calculado (controlo calculado: controlo utilizado num formulário, relatório ou página de acesso a dados para apresentar o resultado de uma expressão. O resultado é calculado de novo sempre que houver uma alteração em qualquer dos valores nos quais a expressão se baseia.) num formulário ou relatório.
Utilize a função DVarP para avaliar o desvio de uma população e a função DVar para avaliar o desvio de uma amostra da população.
Por exemplo, poderá utilizar a função DVar para calcular o desvio de resultados de testes de um conjunto de alunos.
Sintaxe
DVar(expr, domínio [, critérios] )
DVarP(expr, domínio [, critérios] )
As funções DVar e DVarP têm os seguintes argumentos:
| Argumento |
Descrição |
| expr |
Obrigatório. Uma expressão que identifica o campo numérico em que pretende encontrar o desvio. Pode ser uma expressão de cadeia (expressão de cadeia: expressão que equivale a uma sequência de caracteres contíguos. Os elementos da expressão podem ser: funções que devolvem uma cadeia ou uma Variante de cadeia (VarType 8); uma cadeia literal, uma constante, uma variável ou Variante.) que identifique um campo de uma tabela ou consulta ou uma expressão que efectue um cálculo dos dados nesse campo. No argumento expr, pode incluir um campo de nome numa tabela, um controlo num formulário, uma constante ou uma função. Se o argumento expr incluir uma função, esta pode ser incorporada ou definida pelo utilizador, mas não outra função de domínio agregado ou de agregação SQL. Qualquer campo incluído no argumento expr tem de ser um campo numérico. |
| domínio |
Obrigatório. Uma expressão da cadeia que identifica o conjunto de registos que constituem o domínio. Pode ser o nome de uma tabela ou consulta para uma consulta que não necessite de um parâmetro. |
| critérios |
Opcional. Uma expressão da cadeia utilizada para restringir o intervalo de dados em que a função DVar ou DVarP é executada. Por exemplo, o argumento critérios é frequentemente equivalente à cláusula WHERE numa expressão SQL, sem a palavra WHERE. Se omitir o argumento critérios, as funções DVar e DVarP avaliam o argumento expr em relação a todo o domínio. Qualquer campo incluído em critérios também tem de ser um campo em domínio; caso contrário, as funções DVar e DVarP devolvem um valor Nulo (Null: valor que pode introduzir num campo ou utilizar em expressões ou consultas para indicar dados em falta ou desconhecidos. No Visual Basic, a palavra-chave Null indica um valor nulo (Null). Alguns campos, tais como campos de chave primária, não podem conter um valor Null.). |
Observações
Se o domínio se referir a menos de dois registos ou se menos de dois registos cumprirem os critérios, as funções DVar e DVarP devolvem um valor Nulo, a indicar que não é possível calcular um desvio.
Se utilizar a função DVar ou DVarP numa macro, módulo, expressão de consulta ou controlo calculado, terá de construir cuidadosamente o argumento critérios para garantir que o mesmo é avaliado correctamente.
Pode utilizar as funções DVar e DVarP para especificar critérios na linha Critérios de uma consulta de selecção, numa expressão de campo calculado de uma consulta ou na linha Actualizar Para de uma consulta actualização.
Nota Pode utilizar as funções DVar e DVarP ou as funções Var e VarP numa expressão de campo calculado de uma consulta de totais (consulta de totais: consulta que apresenta um cálculo sumário, tal como uma média ou uma soma, para valores existentes em vários campos de uma ou mais tabelas. Uma consulta de totais não é um tipo separado de consulta; pelo contrário, pois permite expandir a flexibilidade das consultas de selecção.). Se utilizar a função DVar ou DVarP, os valores são calculados antes de os dados serem agrupados. Se utilizar a função Var ou VarP, os dados são agrupados antes de os valores na expressão do campo serem avaliados.
Utilize as funções DVar e DVarP num controlo calculado quando necessitar de especificar critérios para restringir o intervalo de dados em que a função é executada. Por exemplo, para visualizar o desvio de encomendas a expedir para o Porto, defina a propriedade OrigemDoControlo de uma caixa de texto com a seguinte expressão:
=DVar("[Frete]", "Encomendas", "[RegiãoDeEnvio] = 'CA'")
Se pretender simplesmente encontrar o desvio-padrão em todos os registos no domínio, utilize a função Var ou VarP.
Nota As alterações não guardadas de registos no domínio não são incluídas quando utilizar estas funções. Se pretender que a função DVar ou DVarP se baseie nos valores alterados, primeiro tem de guardar as alterações clicando em Guardar Registo em Registos no separador Dados, movendo o foco para outro registo ou utilizando o método Actualizar.
Exemplo
Nota Os exemplos que se seguem demonstram a utilização desta função num módulo do Visual Basic for Applications (VBA). Para mais informações sobre como trabalhar com VBA, seleccione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de procura.
O exemplo seguinte devolve estimativas do desvio de uma população e de uma amostra da população para encomendas expedidas para o Reino Unido. O domínio é uma tabela Encomendas. O argumento critérios restringe o conjunto resultante de registos a registos em que o PaísRegiãoDeDestino seja igual a UK.
Dim dblX As Double
Dim dblY As Double
' Estimativa de exemplo.
dblX = DVar("[Frete]", "Encomendas", _
"[PaísRegiãoDeDestino] = 'RU'")
' Estimativa de População.
dblY = DVarP("[Frete]", "Encomendas", _
"[PaísRegiãoDeDestino] = 'RU'")
O exemplo seguinte devolve estimativas utilizando uma variável strCountryRegion, no argumento critérios. Note que são incluídas aspas simples (') na expressão da cadeia, de forma a que quando as cadeias forem concatenadas, a cadeia literal RU seja colocada entre aspas simples.
Dim strCountryRegion As String
Dim dblX As Double
strCountryRegion = "RU"
dblX = DVar("[Frete]", "Encomendas", _
"[PaísRegiãoDeDestino] = '" & strCountryRegion & "'")