defaultcollelem-Attribut

Artikel
06/13/2023

Das Attribut [defaultcollelem] kennzeichnet eine Eigenschaft als Accessorfunktion für ein Element der Standardauflistung.

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

Parameter

property-attribute-list: Andere Attribute, die für die -Eigenschaft gelten.
Rückgabetyp: Gibt den Rückgabetyp der Funktion an.
Eigenschaftsname: Der Name der Eigenschaft.
prop-param-list: Eine Liste von null oder mehr Parametern, die der -Eigenschaft zugeordnet sind.

Bemerkungen

Das Attribut [defaultcollelem] wird für die Visual Basic-Codeoptimierung® verwendet. Wenn ein Member einer Schnittstelle oder eines Dispinterfaces als Accessorfunktion gekennzeichnet ist, geht der Aufruf direkt an dieses Element.

Die Verwendung von [defaultcollelem] muss für eine Eigenschaft konsistent sein. Wenn Sie beispielsweise das Attribut für eine Get-Eigenschaft verwenden, muss es auch für eine Let-Eigenschaft vorhanden sein.

Typeflags-Darstellung

Das Vorhandensein von FUNCFLAG_FDEFAULTCOLLELEM oder VARFLAG_FDEFAULTCOLLELEM.

Beispiele

//A form has a button on it named Button1. 
//To enable use of the property syntax and efficient use of the !
//syntax, the form describes itself in type info this way.
[
    dual,
    uuid(12345678-1234-1234-1234-123456789ABC),
    helpstring("This is IForm"),
    restricted
]
interface IForm1: IForm
{
    [propget, defaultcollelem] HRESULT Button1(
        [out, retval] Button *Value);
}

//User code may access the button using property syntax or ! syntax.

Sub Test()
Dim f as Form1
Dim b1 As Button
Dim b2 As Button

Set f = Form1

Set b1 = f.Button1        ' Property syntax
Set b = f!Button1        ' ! syntax
End Sub

Weitere Informationen

ODL-Dateisyntax
ODL-Dateibeispiel
Generieren einer Typbibliothek mit MIDL