nonbrowsable-Attribut

Artikel
06/13/2023

Verwenden Sie das [nonbrowsable] -Attribut, um eine Schnittstelle oder ein Dispinterface-Element zu markieren, das nicht in einem Eigenschaftenbrowser angezeigt werden soll.

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

Parameter

property-attribute-list: Andere Attribute, die für die -Eigenschaft gelten.
return-type: Der Typ der von der -Methode zurückgegebenen Daten.
Eigenschaftsname: Der Name der Eigenschaft oder Methode.
prop-param-list: Null oder mehr Parameter, die an die -Methode übergeben werden sollen.

Bemerkungen

Bestimmte Eigenschaften sollten nicht in einem Eigenschaftenbrowser angezeigt werden. Dies kann daran liegt, dass das Abrufen des Werts sehr lange dauern würde. Das Beispiel verhindert, dass der Benutzer versucht, die Count-Eigenschaft abzurufen, die die Anzahl der Zeilen im Dynaset zurückgibt. Diese Zahl kann die Ergebnisse einer sehr großen Abfrage darstellen.

Andere Eigenschaften können unerwartete Auswirkungen auf den Browser haben. Betrachten Sie beispielsweise ein Steuerelement mit der Eigenschaft "IsSelected", um zu ermitteln, ob das Steuerelement ausgewählt ist. Wenn "IsSelected" auf false festgelegt ist, durchsucht ein auswahlbasierter Eigenschaftenbrowser ein anderes Objekt.

Beachten Sie, dass eine Eigenschaft, die als [nicht gebrochen] gekennzeichnet ist, weiterhin in einem Objektbrowser angezeigt wird, der keine Eigenschaftswerte anzeigt.

Typeflag-Darstellung

Das Vorhandensein von FUNCFLAG_FNONBROWSABLE oder VARFLAG_FNONBROWSABLE.

Beispiele

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

Weitere Informationen

ODL-Dateisyntax
ODL-Dateibeispiel
Generieren einer Typbibliothek mit MIDL

Share via