nonbrowsable (attributo)

Articolo
06/13/2023

Usare l'attributo [nonbrowsable] per contrassegnare un'interfaccia o un membro dispinterface che non deve essere visualizzato in un browser delle proprietà.

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

Parametri

property-attribute-list: Altri attributi che si applicano alla proprietà.
tipo restituito: Tipo dei dati restituiti dal metodo .
nome della proprietà: Nome della proprietà o del metodo.
prop-param-list: Zero o più parametri da passare al metodo.

Commenti

Alcune proprietà non devono essere visualizzate in un browser delle proprietà. Questo potrebbe essere perché il recupero del valore richiederebbe molto tempo. L'esempio impedisce all'utente di tentare di recuperare la proprietà Count , che restituisce il numero di righe nel dynaset. Questo numero può rappresentare i risultati di una query molto grande.

Altre proprietà potrebbero avere effetti imprevisti sul browser. Si consideri ad esempio un controllo con la proprietà "IsSelected" per indicare se il controllo è selezionato. Se "IsSelected" è impostato su false, un browser di proprietà basato su selezione visualizzerà un oggetto diverso.

Si noti che una proprietà contrassegnata come [nonbrowsable] verrà comunque visualizzata in un browser di oggetti, che non mostra i valori delle proprietà.

Rappresentazione typeflag

Presenza di FUNCFLAG_FNONBROWSABLE o VARFLAG_FNONBROWSABLE.

Esempi

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

Vedere anche

Sintassi del file ODL
Esempio di file ODL
Generazione di una libreria di tipi con MIDL

Condividi tramite