emitidlemitidl

Określa, czy wszystkie kolejne atrybuty IDL są przetwarzane i umieszczane w wygenerowanym pliku IDL.Specifies whether all subsequent IDL attributes are processed and placed in the generated .idl file.

SkładniaSyntax

[ emitidl(state, defaultimports=boolean) ];

ParametryParameters

Państwustate
Jedna z tych możliwych wartości: true , false ,,, forced restricted push lub pop .One of these possible values: true, false, forced, restricted, push, or pop.

  • Jeśli true atrybuty kategorii IDL napotkane w pliku kodu źródłowego są umieszczane w wygenerowanym pliku IDL.If true, any IDL category attributes encountered in a source code file are placed in the generated .idl file. Jest to ustawienie domyślne dla emitidl.This is the default setting for emitidl.

  • Jeśli false atrybuty kategorii IDL napotkane w pliku kodu źródłowego nie zostaną umieszczone w wygenerowanym pliku IDL.If false, any IDL category attributes encountered in a source code file are not placed in the generated .idl file.

  • Jeśli restricted , zezwala, aby atrybuty IDL znajdować się w pliku bez atrybutu modułu .If restricted, allows IDL attributes to be in the file without a module attribute. Kompilator nie generuje pliku IDL.The compiler does not generate an .idl file.

  • Jeśli forced , zastępuje następny restricted atrybut, który wymaga, aby plik miał atrybut, module Jeśli w pliku istnieją atrybuty IDL.If forced, overrides a subsequent restricted attribute, which requires a file to have a module attribute if there are IDL attributes in the file.

  • push umożliwia zapisanie bieżących ustawień emitidl w wewnętrznym stosie emitidl i pop pozwala ustawić emitidl dla każdej wartości w górnej części wewnętrznego stosu emitidl .push lets you save the current emitidl settings to an internal emitidl stack, and pop lets you set emitidl to whatever value is at the top of the internal emitidl stack.

defaultimports=wartość logiczna ( obowiązkowedefaultimports=boolean (optional)

  • Jeśli wartość logiczna to true , docobj. idl zostanie zaimportowany do wygenerowanego pliku IDL.If boolean is true, docobj.idl is imported into the generated .idl file. Ponadto, jeśli plik. idl o takiej samej nazwie jak plik. h, który znajduje się w #include kodzie źródłowym, znajduje się w tym samym katalogu, co plik. h, wygenerowany plik. idl zawiera instrukcję import dla tego pliku IDL.Also, if an .idl file with the same name as an .h file that you #include into your source code is found in the same directory as the .h file, then the generated .idl file contains an import statement for that .idl file.

  • Jeśli wartość logiczna to false , docobj. idl nie jest zaimportowana do wygenerowanego pliku IDL.If boolean is false, docobj.idl is not imported into the generated .idl file. Należy jawnie zaimportować pliki. idl przy użyciu importu.You must explicitly import .idl files with import.

UwagiRemarks

Po napotkaniu atrybutu emitidl C++ w pliku z kodem źródłowym atrybuty kategorii IDL są umieszczane w wygenerowanym pliku IDL.After the emitidl C++ attribute is encountered in a source code file, IDL category attributes are placed in the generated .idl file. Jeśli nie istnieje atrybut emitidl , atrybuty IDL w pliku kodu źródłowego są wyprowadzane do wygenerowanego pliku IDL.If there is no emitidl attribute, IDL attributes in the source code file are output to the generated .idl file.

W pliku kodu źródłowego można mieć wiele atrybutów emitidl .It is possible to have multiple emitidl attributes in a source code file. Jeśli [emitidl(false)]; program zostanie napotkany w pliku bez kolejnych [emitidl(true)]; , wówczas żadne atrybuty nie są przetwarzane do wygenerowanego pliku IDL.If [emitidl(false)]; is encountered in a file without a subsequent [emitidl(true)];, then no attributes are processed into the generated .idl file.

Za każdym razem, gdy kompilator napotyka nowy plik, emitidl jest niejawnie ustawiony na true .Each time the compiler encounters a new file, emitidl is implicitly set to true.

WymaganiaRequirements

Kontekst atrybutuAttribute context WartośćValue
DotyczyApplies to Dowolne miejsceAnywhere
PowtarzalnośćRepeatable NieNo
Wymagane atrybutyRequired attributes BrakNone
Nieprawidłowe atrybutyInvalid attributes BrakNone

Aby uzyskać więcej informacji, zobacz konteksty atrybutów.For more information, see Attribute Contexts.

Zobacz teżSee also

Atrybuty kompilatoraCompiler Attributes
Atrybuty autonomiczneStand-Alone Attributes