Udostępnij przez


Dodawanie właściwości IDL MFC

Kreator dodawania właściwości IDL MFC dodaje właściwość do interfejsu biblioteki IDL (Interface Definition Library) zdefiniowanego w projekcie Klasy platformy Microsoft (MFC).

Aby użyć tego kreatora, musisz znajdować się w projekcie MFC, projekcie ActiveX lub projekcie ATL obsługującym MFC. Jeśli na przykład masz projekt kontrolki Microsoft ActiveX, możesz użyć poniższej procedury, aby dodać właściwość do interfejsu IDL w rozwiązaniu.

Dodawanie właściwości IDL MFC do interfejsu

  1. W menu Widok wybierz pozycję Widok klasy.

  2. W okienku Widok klasy kliknij prawym przyciskiem myszy nazwę interfejsu, do którego chcesz dodać właściwość.

    Uwaga

    Można również dodać właściwości do dispinterfaces, które, chyba że projekt jest przypisany, są zagnieżdżone w węźle biblioteki.

  3. Z menu skrótów wybierz pozycję Dodaj>właściwość.

  4. W kreatorze dodawania właściwości IDL MFC podaj informacje, aby utworzyć właściwość.

  5. Wybierz przycisk OK , aby dodać właściwość.

W przypadku MFC dispinterfaces:

  • W przypadku wybrania zmiennej składowej jako typu implementacji metoda i zmienna zostaną dodane do klasy, która ją implementuje.
  • W przypadku wybrania opcji Pobierz/Ustaw metody jako typu implementacji zostaną dodane dwie metody do klasy, która ją implementuje.

Lista elementów interfejsu użytkownika

W poniższej sekcji opisano kreatora dodawania właściwości IDL MFC:

Zrzut ekranu przedstawiający dodawanie właściwości IDL MFC z dwoma parametrami: int i i char c. Typ właściwości to OLE_COLOR.

  • Nazwa właściwości

    Ustawia nazwę właściwości.

    W przypadku kontrolek MFC dispinterfaces skojarzonych z kontrolkami ActiveX możesz podać własną nazwę lub wybrać nazwę właściwości akcji ze wstępnie zdefiniowanej listy. Jeśli podasz własną nazwę właściwości, typ implementacji stock jest niedostępny.

    Aby uzyskać więcej informacji na temat opisu właściwości zapasów na liście, zobacz właściwości zapasów.

    Typ interfejsu Opcje nazwy właściwości
    Podwójny interfejs ATL, interfejs niestandardowy i lokalny interfejs niestandardowy Podaj nazwę właściwości.
    MFC dispinterface, kontrolka ActiveX MFC dispinterface Podaj nazwę właściwości lub wybierz właściwość stock z listy.

    Jeśli wybierzesz właściwość z listy, w polu Typ właściwości zostanie wyświetlona odpowiednia wartość. Ten typ można zmienić w zależności od wybranego typu implementacji.
  • Typ właściwości

    Ustawia typ dodawanej właściwości.

    W przypadku aplikacji MFC dispinterfaces podaj własny typ lub wybierz go ze wstępnie zdefiniowanej listy. Jeśli podasz implementację akcji właściwości, typ właściwości jest typem akcji i nie można go zmienić.

  • Nazwa zmiennej

    Ustawia nazwę zmiennej składowej, z którą jest skojarzona właściwość.

    Domyślnie nazwa zmiennej to m_PropertyName. Możesz edytować tę nazwę.

    To pole jest widoczne tylko dla MFC dispinterfaces i jeśli określisz zmienną składową w obszarze Typ implementacji.

  • Funkcja powiadamiania

    Ustawia nazwę funkcji powiadamiania o nazwie , jeśli właściwość ulegnie zmianie.

    Domyślnie nazwa funkcji powiadamiania to OnPropertyNameChanged Możesz edytować tę nazwę.

    To pole jest widoczne tylko dla MFC dispinterfaces i jeśli określisz zmienną składową w obszarze Typ implementacji.

  • Funkcja Get

    Ustawia nazwę funkcji, aby pobrać właściwość .

    Domyślnie nazwa Get funkcji to GetPropertyName. Możesz edytować tę nazwę.

    Jeśli usuniesz nazwę, funkcja GetNotSupported zostanie wstawiona do mapy wysyłania interfejsu.

    To pole jest widoczne tylko dla MFC dispinterfaces i jeśli określisz metody Get/Set w obszarze Typ implementacji.

  • Set, funkcja

    Ustawia nazwę funkcji, aby ustawić właściwość .

    Domyślnie nazwa Set funkcji to SetPropertyName. Możesz edytować tę nazwę.

    Jeśli usuniesz nazwę, funkcja SetNotSupported zostanie wstawiona do mapy wysyłania interfejsu.

    To pole jest widoczne tylko dla MFC dispinterfaces i jeśli określisz metody Get/Set w obszarze Typ implementacji.

  • Typ implementacji

    Określa sposób implementowania dodawanej właściwości.

    Dostępne tylko dla MFC dispinterfaces.

    Typ implementacji opis
    Skład Określa domyślną implementację właściwości wybranej w nazwie właściwości. Aby uzyskać więcej informacji, zobacz właściwości zapasów.
    Jeśli określisz wartość Stock, typ właściwości, typ parametru i nazwa parametru zostaną wygaszone.
    Zmienna składowa Dodaje właściwość jako zmienną składową.
    Właściwości niestandardowe lub większość właściwości standardowych można dodawać jako zmienne składowe.
    Udostępnia nazwy domyślne w obszarze Nazwa zmiennej i Funkcja powiadomień. Możesz edytować tę nazwę.
    Nie można określić zmiennej składowej dla Captionwłaściwości , hWndlub Text .
    Metody Get/Set Określa właściwość jest domyślnie dodawana jako Getwłaściwości PropertyName i SetPropertyName . Te nazwy są wyświetlane w obszarze Pobierz funkcję i Ustaw funkcję.
    Możesz zmienić domyślny typ właściwości, który przekazuje wartość funkcji Get.
    Parametry dla Get funkcji i Set można określić.
  • Właściwość domyślna

    Ustawia właściwość jako domyślną dla interfejsu.

    Interfejs może mieć tylko jedną właściwość domyślną.

    Po określeniu właściwości domyślnej to pole wyboru jest niedostępne dla innych właściwości dodanych do interfejsu. Dostępne tylko dla MFC dispinterface.

  • Parametry

    Wyświetla parametry metody i jej typy.

  • +

    Dodaje parametr. W obszarze Parametry wpisz typ parametru i nazwę, a następnie wybierz przycisk OK. Na przykład int x

  • x

    Usuwa wybrany parametr z listy Parametry .

  • Ikona ołówka

    Edytuje wybrany parametr.

  • id

    Ustawia identyfikator liczbowy identyfikujący właściwość .

    Ta opcja nie jest dostępna dla właściwości interfejsów niestandardowych. Aby uzyskać więcej informacji, zobacz id w dokumentacji MIDL.

  • helpcontext

    Określa identyfikator kontekstu, który umożliwia użytkownikowi wyświetlanie informacji o tej właściwości w pliku Pomocy.

    Aby uzyskać więcej informacji, zobacz helpcontext w dokumentacji MIDL.

  • helpstring

    Określa ciąg znaków używany do opisania elementu, do którego ma on zastosowanie. Domyślnie jest propertyto nazwa właściwości.

    Aby uzyskać więcej informacji, zobacz helpstring w dokumentacji MIDL.

Właściwości zapasów

Jeśli dodasz właściwość do biblioteki MFC dispinterface, możesz wybrać jedną z następujących właściwości magazynowych z listy rozwijanej Nazwa właściwości :

Nazwa właściwości opis
Appearance Zwraca lub ustawia wartość, która określa wygląd kontrolki.
Właściwość kontrolki może zawierać lub pomijać efekty wyświetlania Appearance trójwymiarowego. Ta właściwość jest właściwością otoczenia odczytu/zapisu.
BackColor Zwraca lub ustawia właściwość otoczenia BackColor kontrolki na kolor palety (RGB) lub wstępnie zdefiniowany kolor systemu.
Domyślnie jego wartość odpowiada kolorowi pierwszego planu kontenera kontrolki.
Ta właściwość jest właściwością otoczenia odczytu/zapisu.
BorderStyle Zwraca lub ustawia styl obramowania dla kontrolki.
Ta właściwość jest właściwością odczytu/zapisu.
Caption Zwraca lub ustawia właściwość kontrolki Caption .
Podpis jest tytułem okna. Caption nie ma typu implementacji zmiennej składowej .
Enabled Zwraca lub ustawia właściwość kontrolki Enabled .
Włączona kontrolka może reagować na zdarzenia generowane przez użytkownika.
Font Zwraca lub ustawia czcionkę otoczenia kontrolki.
Null jeśli kontrolka nie ma czcionki.
ForeColor Zwraca lub ustawia właściwość otoczenia ForeColor kontrolki.
hWnd Zwraca lub ustawia właściwość kontrolki hWnd .
Nie ma typu implementacji zmiennej składowej.
ReadyState Zwraca lub ustawia właściwość kontrolki ReadyState .
Kontrolka może być niezainicjowana, zainicjowana, ładowana, interaktywna lub kompletna.
Aby uzyskać więcej informacji, zobacz READYSTATE w internetowym zestawie SDK.
Text Zwraca lub ustawia tekst zawarty w kontrolce.
Nie ma typu implementacji zmiennej składowej.

Zobacz także

Dodaj właściwość

Dodawanie właściwości IDL