Dodawanie metody IDL

Kreator dodawania metody IDL dodaje metodę do interfejsu biblioteki IDL (Interface Definition Library), na przykład w projekcie ATL, który zawiera plik IDL. Ten kreator nie jest dostępny w projektach obsługujących MFC.

Ten kreator różni się od kreatora Dodawanie metody i kreatora metody IDL MFC w następujący sposób:

• Kreator dodawania metody dodaje metodę do interfejsu w projekcie i może zaktualizować klasę skojarzona z interfejsem.
• Kreator metody Add IDL MFC jest specyficzny dla projektów MFC, ActiveX lub ATL, które obsługują MFC.

Dodawanie metody do interfejsu IDL

1. W menu Widok wybierz pozycję Widok klasy.

2. W okienku Widok klasy rozwiń węzeł projektu, aby wyświetlić interfejs IDL (.idl plik), do którego chcesz dodać metodę.

3. Kliknij prawym przyciskiem myszy nazwę interfejsu.

4. W menu skrótów wybierz pozycję Dodaj>metodę.

5. W kreatorze Dodawanie metody IDL podaj informacje, aby utworzyć metodę.

6. Wybierz przycisk OK , aby dodać metodę.

Lista elementów interfejsu użytkownika

W poniższej sekcji opisano interfejs kreatora, którego użyjesz do dodania metody:

• Nazwa metody

  Podaj nazwę metody .

• Zwracany typ

  Typ danych zwracany przez metodę . Standardowym sposobem zwracania kodów błędów z metod zdefiniowanych w interfejsie jest użycie elementu HRESULT.

  W poniższej tabeli opisano różne rodzaje interfejsów, do których można dodać metodę, oraz dozwolony typ zwracany. W przypadku interfejsów podwójnych i niestandardowych zwracany typ musi być HRESULT i kreator nie pozwoli na jego zmianę.

  Rodzaj interfejsu	Typ zwracany
  Podwójny interfejs	HRESULT. Niezmienne.
  Interfejs niestandardowy	HRESULT. Niezmienne.
  Lokalny interfejs niestandardowy	Podaj własny typ powrotu lub wybierz go z listy rozwijanej.
  Dispinterface	Podaj własny typ powrotu lub wybierz go z listy rozwijanej.

• Parametry

  Wyświetla parametry, modyfikatory i typy metody.

• +

  Dodaj parametr. W obszarze Parametry wpisz typ parametru, nazwę i wszelkie modyfikatory. Na przykład [in] int i, i wybierz przycisk OK.

• x

  Usuwa wybrany parametr z listy Parametry .

• Wnioskowanie wartości parametrów w/wy z typów

  Wstawia [in] atrybut or [out] na podstawie typu parametru.

• Ustaw ostatni parametr jako wartość zwracaną (retval)

  Ostatni parametr będzie traktowany jako wartość zwracana metody.

• Atrybuty

  Następujące atrybuty są również opisane w dokumentacji MIDL.

  • id

    Ustawia identyfikator liczbowy identyfikujący metodę. Aby uzyskać więcej informacji, zobacz id.

  • call_as

    Określa nazwę metody zdalnej do mapowania na tę metodę lokalną. Aby uzyskać więcej informacji, zobacz call_as.

  • helpcontext

    Określa identyfikator kontekstu, który umożliwia użytkownikowi wyświetlanie informacji o tej metodzie w pliku Pomocy. Aby uzyskać więcej informacji, zobacz helpcontext.

  • helpstring

    Określa ciąg znaków używany do opisania elementu, do którego ma on zastosowanie. Aby uzyskać więcej informacji, zobacz helpstring.

• Dodatkowe atrybuty

  • hidden

    Wskazuje, że element istnieje, ale nie powinien być wyświetlany w przeglądarce zorientowanej na użytkownika. Aby uzyskać więcej informacji, zobacz hidden.

  • local

    Określa, że interfejs lub funkcja nie jest zdalna. Aby uzyskać więcej informacji, zobacz local.

  • restricted

    Określa, że biblioteka lub element członkowski modułu, interfejsu lub dispinterface nie może być wywoływana dowolnie. Aby uzyskać więcej informacji, zobacz restricted.

  • source

    Wskazuje, że element członkowski coclasswłaściwości lub metody jest źródłem zdarzeń. W przypadku elementu członkowskiego coclassatrybutu ten atrybut oznacza, że element członkowski jest wywoływany, a nie implementowany. Aby uzyskać więcej informacji, zobacz source.

Zobacz też

Dodawanie kreatora metody
Dodawanie kreatora metody IDL MFC