atributo nonbrowsable

  • Artigo

Use o atributo [nonbrowsable] para marcar uma interface ou membro dispinterface que não deve ser exibido em um navegador de propriedades.

[property-attribute-list, nonbrowsable]return-type property-name(prop-param-list)

Parâmetros

property-attribute-list

Outros atributos que se aplicam à propriedade .

return-type

O tipo dos dados retornados pelo método .

property-name

O nome da propriedade ou método.

prop-param-list

Zero ou mais parâmetros a serem passados para o método .

Comentários

Determinadas propriedades não devem ser exibidas em um navegador de propriedades. Isso pode ser porque a recuperação do valor levaria muito tempo. O exemplo impede que o usuário tente recuperar a propriedade Count , que retorna o número de linhas no dynaset. Esse número pode representar os resultados de uma consulta muito grande.

Outras propriedades podem ter efeitos inesperados no navegador. Por exemplo, considere um controle com a propriedade "IsSelected" para informar se o controle está selecionado. Se "IsSelected" for definido como false, um navegador de propriedades baseado em seleção procurará um objeto diferente.

Observe que uma propriedade marcada como [nonbrowsable] ainda aparecerá em um navegador de objetos, que não mostra valores de propriedade.

Representação typeflag

A presença de FUNCFLAG_FNONBROWSABLE ou VARFLAG_FNONBROWSABLE.

Exemplos

[
    dual,
    uuid(12345678-1234-1234-1234-123456789ABC),
    restricted
]
interface IDynaset:IDispatch
{
    [propget, nonbrowsable]HRESULT Count([out, retval] long *Value);
}

Confira também

Sintaxe de arquivo ODL

Exemplo de arquivo ODL

Gerando uma biblioteca de tipos com MIDL