nonbrowsable (attribut)

Article
06/13/2023

Utilisez l’attribut [nonbrowsable] pour baliser un membre d’interface ou dispinterface qui ne doit pas être affiché dans un navigateur de propriétés.

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

Paramètres

property-attribute-list: Autres attributs qui s’appliquent à la propriété .
return-type: Type des données retournées par la méthode .
property-name: Nom de la propriété ou de la méthode.
prop-param-list: Zéro ou plusieurs paramètres à passer à la méthode.

Notes

Certaines propriétés ne doivent pas être affichées dans un navigateur de propriétés. Cela peut être dû au fait que la récupération de la valeur prend beaucoup de temps. L’exemple empêche l’utilisateur de tenter de récupérer la propriété Count , qui retourne le nombre de lignes dans la feuille de dialogue. Ce nombre peut représenter les résultats d’une requête très volumineuse.

D’autres propriétés peuvent avoir des effets inattendus sur le navigateur. Par exemple, considérez un contrôle avec la propriété « IsSelected » pour indiquer si le contrôle est sélectionné. Si « IsSelected » a la valeur false, un navigateur de propriétés basé sur la sélection parcourra un autre objet.

Notez qu’une propriété marquée comme [non extensible] apparaît toujours dans un navigateur d’objets, qui n’affiche pas les valeurs de propriété.

Représentation typeflag

Présence de FUNCFLAG_FNONBROWSABLE ou de VARFLAG_FNONBROWSABLE.

Exemples

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

Voir aussi

Syntaxe de fichier ODL
Exemple de fichier ODL
Génération d’une bibliothèque de types avec MIDL

Partager via