Atrybuty IDL

Tradycyjnie utrzymywanie pliku .idl oznaczało, że:

• Znać struktury i składnię pliku .idl, aby móc go zmodyfikować.

• Zależne od kreatora, które byłyby pozwalają zmodyfikować niektóre aspekty pliku .idl.

Teraz można zmodyfikować plik .idl z wewnątrz pliku kodu źródłowego przy użyciu programu Visual C++, IDL atrybutów.W wielu przypadkach Visual C++, IDL atrybuty mają taką samą nazwę jak atrybuty MIDL.Nazwa atrybutu Visual C++, IDL i atrybut MIDL są takie same, oznacza, że wprowadzenie atrybutu Visual C++ w pliku kodu źródłowego wyniku w pliku .idl, który zawiera atrybut MIDL jego imiennik.Jednakże atrybut Visual C++, IDL może nie zapewniać wszystkie funkcje atrybutu MIDL.

Gdy nie jest używany z atrybuty kom, atrybuty IDL umożliwiają definiowanie interfejsów.Podczas kompilowania kodu źródłowego, atrybuty są używane do definiowania plik wygenerowany .idl.Gdy używana z atrybutów COM w projekcie ATL, IDL niektóre atrybuty, takie jak coclass, spowodować, że kod, aby być nastrzyknięta do projektu.

Należy zauważyć, że idl_quote pozwala używać konstrukcje MIDL, które nie są obsługiwane w bieżącej wersji programu Visual C++.Ten i inne atrybuty, takie jak importlib i includelib pomagają korzystać z istniejących plików .idl w bieżącym projekcie Visual C++.

Atrybut	Opis
Kumulowalne	Wskazuje, że formant mogą zostać zagregowane przez inny formant.
appobject	Identyfikuje coclass jako obiekt aplikacji, który jest skojarzony z pełnego stosowania EXE i wskazuje, że funkcje i właściwości coclass są globalnie dostępnej w tej bibliotece typów.
async_uuid	Określa identyfikator UUID kierujący kompilator MIDL, aby zdefiniować synchroniczne i asynchroniczne wersje interfejsu COM.
które można powiązać	Wskazuje, że właściwość obsługuje wiązania z danymi.
call_as	Włącza funkcję nonremotable mają być mapowane do funkcji zdalnego.
sprawa	Używane z switch_type atrybutu w Unii.
"coclass"	Miejsca klasy definicji do pliku .idl jako "coclass".
Kontrola	Określa, że typ zdefiniowany przez użytkownika jest formant.
cpp_quote	Emituje określonego ciągu znaków, bez znaków oferty do pliku wygenerowanego nagłówka.
defaultbind	Wskazuje właściwość pojedynczej, które można powiązać najlepiej reprezentuje obiekt.
defaultcollelem	Używany do optymalizacji kodu języka Visual Basic.
DefaultValue	Pozwala specyfikacja wartość domyślną dla wpisany parametr opcjonalny.
domyślne	Wskazuje, że niestandardowe lub zdefiniowane w ramach coclass dispinterface reprezentuje domyślnego interfejsu programowania.
defaultvtable	Definiuje interfejsu jako interfejsu domyślnego vtable dla formantu.
Interfejs rozdzielania	Miejsca interfejsu w pliku .idl jako interfejs wysyłki.
displaybind	Wskazuje właściwość, które powinny być wyświetlane dla użytkownika, w które można powiązać.
podwójne	Miejsca interfejsu w pliku .idl jako podwójnym interfejsem.
wpis	Określa wyeksportowanej funkcji lub stałej w module, identyfikując punktu wejścia w bibliotece DLL.
first_is	Określa indeks pierwszy element tablicy, które mają być przekazywane.
helpcontext	Określa identyfikator kontekstu, który pozwala widoku informacje dotyczące elementu w pliku pomocy.
HelpFile	Ustawia nazwę pliku pomocy dla biblioteki typów.
helpstringcontext	Określa identyfikator tematu pomocy w pliku hlp lub chm.
helpstringdll	Określa nazwę biblioteki DLL, aby użyć, aby wykonać wyszukiwanie ciągu dokumentu (lokalizacja).
Ciąg HelpString	Określa ciąg znaków, który jest używany do opisu elementu, do którego ma zastosowanie.
ukryte	Wskazuje, że element istnieje, ale nie powinien być wyświetlany w przeglądarce zorientowana na użytkownika.
idl_module	Określa punkt wejścia w bibliotece DLL.
idl_quote	Pozwala na używanie atrybutów lub IDL konstrukcje, które nie są obsługiwane w bieżącej wersji programu Visual C++.
Identyfikator	Określa DISPID dla funkcji Członkowskich (właściwość lub metodę, interfejsu lub dispinterface).
iid_is	Określa identyfikator IID interfejsu COM wskazywanej przez wskaźnika interfejsu.
immediatebind	Wskazuje, że baza danych zostanie niezwłocznie poinformowana o wszystkie zmiany do właściwości obiektu powiązanego z danymi.
importlib	Sprawia, że typy, które już zostały skompilowane w bibliotece typu tworzonego innej bibliotece typu.
Importowanie	Określa inny plik .idl, .odl lub nagłówka zawierającej definicje, które chcesz odwołać się od pliku głównego .idl.
obejmują	Określa jeden lub więcej plików nagłówka mają zostać uwzględnione w pliku .idl wygenerowany.
includelib	Powoduje, że plik .idl lub .h mają zostać uwzględnione w pliku .idl wygenerowany.
w	Wskazuje, że parametr jest przekazywane z wywołanie procedury do wywołana procedury.
last_is	Określa indeks ostatni element tablicy mają być przekazywane.
Identyfikator LCID	Umożliwia przekazywanie identyfikatora ustawień regionalnych do funkcji.
length_is	Określa liczbę elementów tablicy, które mają być przekazywane.
licencjonowane	Wskazuje, że jest licencjonowany coclass, do którego ma zastosowanie i musi być utworzone przy użyciu IClassFactory2.
lokalne	Pozwala użyć kompilator MIDL jako generator nagłówka, używany w nagłówku interfejsu.Gdy używane w poszczególnych funkcji, wyznacza lokalnej procedury, dla których są generowane nie procedur wejścia.
max_is	Wyznacza maksymalną wartość dla indeksu tablicy ważne.
Moduł	Definiuje bloku biblioteki w pliku .idl.
ms_union	Określa wyrównanie reprezentacji danych sieci związków nonencapsulated.
no_injected_text	Kompilator uniemożliwia wstrzyknięcie kodu z użycia atrybutu.
nonbrowsable	Wskazuje, że do członka interfejsu nie powinien być wyświetlany w przeglądarce właściwości.
noncreatable	Definiuje obiekt, którego nie można utworzyć wystąpienia samodzielnie.
nonextensible	Określa, że IDispatch implementacja obejmuje tylko właściwości i metod wymienionych w polu Opis interfejsu i nie może zostać rozszerzony o dodatkowych członków w czasie wykonywania.
obiekt	Identyfikuje interfejs niestandardowy; synonim ze atrybutu niestandardowego.
wykładowcom	Identyfikuje interfejsu jako interfejsu języka opisu obiektu (Wykładowcom).
oleautomation	Wskazuje, że interfejs jest zgodny z automatyzacji.
opcjonalne	Określa opcjonalny parametr dla funkcji składowej.
Wyjście	Identyfikuje wskaźnik parametrów, które są zwracane z wywołana procedury wywołanie procedury (z serwera do klienta).
pointer_default	Określa domyślny atrybut wskaźnik dla wszystkich wskaźników, z wyjątkiem najwyższego poziomu wskaźniki, które pojawiają się w listy parametrów.
pragma	Emituje określonego ciągu znaków, bez znaków oferty do pliku wygenerowanego .idl.
Identyfikator programu	Określa identyfikator ProgID dla obiektu COM.
propget	Określa właściwość funkcji akcesor (get).
propputref	Określa funkcję ustawienie właściwości, która używa odwołanie zamiast wartości.
propput	Określa funkcję ustawienie właściwości.
PTR	Wyznacza wskaźnik jako wskaźnik pełne.
publiczne	Zapewnia jako element typedef, przejdzie do biblioteki typów, nawet jeśli nie jest wywoływany z w pliku .idl.
zakres	Określa zakres wartości dopuszczalne dla argumentów lub pól, których wartości są ustawione w czasie wykonywania.
tylko do odczytu	Nie pozwalają na przypisanie zmiennej.
REF	Identyfikuje wskaźnik odwołania.
requestedit	Wskazuje, że obsługuje właściwość OnRequestEdit powiadomienia.
z ograniczeniami	Określa, że biblioteka lub moduł, interfejsu lub dispinterface nie można wywołać arbitralnie.
Parametr Retval	Wyznacza parametr, który odbiera wartość zwracaną członka.
size_is	Określa rozmiar pamięci przydzielone dla średnich wskaźników, o rozmiarze wskaźniki do średnich wskaźników i jedno - lub tablice wielowymiarowe.
źródła	Wskazuje, że członek klasy, właściwość lub metoda jest źródłem zdarzeń.
ciąg	Wskazuje, że jednowymiarowe char, wchar_t, bajt, lub równoważnych tablicy lub wskaźnika do takiej tablicy muszą być traktowane jako ciąg.
switch_is	Określa wyrażenie lub identyfikator działający jako Unii wyróżnik, który wybiera członka Unii.
switch_type	Identyfikuje typ zmiennej używanej jako wyróżnik Unii.
transmit_as	Nakazuje kompilatorowi skojarzyć przedstawione typu, które aplikacje klienckie i serwerowe manipulować, z rodzaju przekazywanych.
uidefault	Wskazuje, że członek typu informacji jest domyślny element członkowski do wyświetlania w interfejsie użytkownika.
unikatowe	Określa unikatowy wskaźnik.
usesgetlasterror	Obiekt wywołujący informuje, że jeśli wystąpi błąd podczas wywoływania funkcji, obiekt wywołujący może wywoływać GetLastError do pobrania kodu błędu.
UUID	Określa unikatowy identyfikator klasy lub interfejsu.
v1_enum	Kieruje się, że określony typ wyliczany należy przekazywać jako podmiot 32-bitowe zamiast domyślnego 16-bitowych.
element vararg	Określa, że funkcja podjąć zmiennej liczbie argumentów.
vi_progid	Określa formularz niezależny od wersji identyfikatora ProgID.
wire_marshal	Określa typ danych, który będzie używany do przesyłania, zamiast typu danych specyficznych dla aplikacji.

Zobacz też

Koncepcje

Atrybut ograniczenia

Inne zasoby

Atrybuty grupy