Lägga till en IDL MFC-egenskap

Guiden Lägg till IDL MFC-egenskap lägger till en egenskap i ett gränssnitt för gränssnittsdefinitionsbiblioteket (IDL) som definierats i ditt MFC-projekt (Microsoft Framework Class).

Om du vill använda den här guiden måste du vara i ett MFC-projekt, Ett ActiveX-projekt eller ett ATL-projekt som stöder MFC. Om du till exempel har ett Microsoft ActiveX-kontrollprojekt kan du använda följande procedur för att lägga till en egenskap i ett IDL-gränssnitt i lösningen.

Lägga till en IDL MFC-egenskap i gränssnittet

  1. På menyn Visa väljer du Klassvy.

  2. I fönstret Klassvy högerklickar du på namnet på det gränssnitt som du vill lägga till egenskapen i.

    Anmärkning

    Du kan också lägga till egenskaper i dispinterfaces, som, om inte projektet tillskrivs, är kapslade i biblioteksnoden.

  3. På snabbmenyn väljer du Lägg till lägg till>egenskap.

  4. I guiden Lägg till IDL MFC-egenskap anger du informationen för att skapa egenskapen.

  5. Välj OK för att lägga till egenskapen.

För MFC dispinterfaces:

  • Om du väljer Medlemsvariabel som implementeringstyp läggs en metod och en variabel till i klassen som implementerar den.
  • Om du väljer Get/Set-metoder som implementeringstyp läggs två metoder till i klassen som implementerar den.

Lista över användargränssnittselement

I följande avsnitt beskrivs guiden Lägg till IDL MFC-egenskap :

Skärmbild av Lägg till IDL MFC-egenskap med två parametrar: int i och char c. Egenskapstypen är OLE_COLOR.

  • Egenskapsnamn

    Anger namnet på egenskapen.

    För MFC-dispinterfaces som är associerade med ActiveX-kontroller kan du ange ditt eget namn eller välja ett lageregenskapsnamn från den fördefinierade listan. Om du anger ditt eget egenskapsnamn är implementeringstypen Lager inte tillgänglig.

    Mer information om en beskrivning av lageregenskaperna i listan finns i lageregenskaper.

    Gränssnittstyp Alternativ för egenskapsnamn
    DUBBLA ATL-gränssnitt, anpassat gränssnitt och lokalt anpassat gränssnitt Ange ett egenskapsnamn.
    MFC dispinterface, MFC ActiveX kontroll dispinterface Ange ett egenskapsnamn eller välj en aktieegenskap i listan.

    Om du väljer en egenskap i listan visas lämpligt värde i rutan Egenskapstyp . Du kan ändra den här typen, beroende på valet av implementeringstyp .
  • Egenskapstyp

    Anger vilken typ av egenskap du lägger till.

    För MFC-dispinterfaces anger du din egen typ eller väljer från den fördefinierade listan. Om du anger en lagerimplementering av en egenskap är egenskapstypen lagertypen och kan inte ändras.

  • variabelnamn

    Anger namnet på medlemsvariabeln som egenskapen är associerad med.

    Som standard är m_ variabelnamnet PropertyName. Du kan redigera det här namnet.

    Det här fältet är bara synligt för MFC-dispinterfaces och om du anger medlemsvariabel under Implementeringstyp.

  • Meddelandefunktion

    Anger namnet på meddelandefunktionen som anropas om egenskapen ändras.

    Som standard är On namnet på meddelandefunktionen PropertyNameChanged. Du kan redigera det här namnet.

    Det här fältet är bara synligt för MFC-dispinterfaces och om du anger medlemsvariabel under Implementeringstyp.

  • Hämta funktion

    Anger namnet på funktionen för att hämta egenskapen.

    Som standard är Get namnet på Get funktionen PropertyName. Du kan redigera det här namnet.

    Om du tar bort namnet infogas funktionen GetNotSupported i gränssnittets sändningskarta.

    Det här fältet är bara synligt för MFC-dispinterfaces och om du anger Get/Set-metoder under Implementeringstyp.

  • Ange funktion

    Anger namnet på funktionen för att ange egenskapen.

    Som standard är Set namnet på Set funktionen PropertyName. Du kan redigera det här namnet.

    Om du tar bort namnet infogas funktionen SetNotSupported i gränssnittets sändningskarta.

    Det här fältet är bara synligt för MFC-dispinterfaces och om du anger Get/Set-metoder under Implementeringstyp.

  • Implementeringstyp

    Anger hur du implementerar den egenskap som du lägger till.

    Endast tillgängligt för MFC-dispinterfaces.

    Implementeringstyp Beskrivning
    Aktie Anger en standardimplementering för egenskapen som valts i Egenskapsnamn. Mer information finns i lageregenskaper.
    Om du anger Lager är egenskapstypen, parametertypen och parameternamnet nedtonade.
    Medlemsvariabel Lägger till egenskapen som en medlemsvariabel.
    Du kan lägga till anpassade egenskaper eller de flesta lageregenskaper som medlemsvariabler.
    Innehåller standardnamn under Variabelnamn och Meddelandefunktion. Du kan redigera det här namnet.
    Du kan inte ange medlemsvariabelnCaptionför egenskaperna , hWndeller Text .
    Hämta/ange metoder Anger att egenskapen läggs till som Getfunktioner för PropertyName och SetPropertyName som standard. Dessa namn visas under Funktionen Hämta och Ange.
    Du kan ändra standardegenskapstypen, som skickar ett värde för funktionen Get.
    Du kan ange parametrar för Get funktionerna och Set .
  • Standardegenskap

    Anger egenskapen som standard för gränssnittet.

    Ett gränssnitt kan bara ha en standardegenskap.

    När du har angett standardegenskapen är den här kryssrutan inte tillgänglig för andra egenskaper som du lägger till i gränssnittet. Endast tillgängligt för ett MFC-dispinterface.

  • Parameters

    Visar metodens parametrar och dess typer.

  • +

    Lägger till en parameter. I Parametrar skriver du parametertypen och namnet och väljer OK. Till exempel: int x

  • x

    Tar bort den valda parametern från listan Parametrar .

  • Penna ikon

    Redigerar den valda parametern.

  • ID

    Anger det numeriska ID som identifierar egenskapen.

    Det här alternativet är inte tillgängligt för egenskaper för anpassade gränssnitt. Mer information id finns i MIDL-referensen.

  • helpcontext

    Anger ett kontext-ID som låter användaren visa information om den här egenskapen i hjälpfilen.

    Mer information helpcontext finns i MIDL-referensen.

  • helpstring

    Anger en teckensträng som används för att beskriva det element som det gäller för. Som standard är det Egenskapsnamnproperty.

    Mer information helpstring finns i MIDL-referensen.

Lageregenskaper

Om du lägger till en egenskap i ett MFC-dispinterface kan du välja någon av följande aktieegenskaper i listrutan Egenskapsnamn :

Egenskapsnamn Beskrivning
Appearance Returnerar eller anger ett värde som avgör kontrollens utseende.
Kontrollens egenskap kan innehålla eller utelämna tredimensionella visningseffekter Appearance . Den här egenskapen är en omgivande läs-/skrivegenskap.
BackColor Returnerar eller anger kontrollens omgivande BackColor egenskap till antingen en palettfärg (RGB) eller en fördefinierad systemfärg.
Som standard motsvarar dess värde för förgrundsfärgen för kontrollens container.
Den här egenskapen är en omgivande läs-/skrivegenskap.
BorderStyle Returnerar eller anger kantlinjeformatet för en kontroll.
Den här egenskapen är en läs-/skrivegenskap.
Caption Returnerar eller anger kontrollens Caption egenskap.
Rubriken är fönstrets rubrik. Caption har ingen implementeringstyp för medlemsvariabeln .
Enabled Returnerar eller anger kontrollens Enabled egenskap.
En aktiverad kontroll kan svara på användargenererade händelser.
Font Returnerar eller anger kontrollens omgivande teckensnitt.
Null om kontrollen inte har något teckensnitt.
ForeColor Returnerar eller anger kontrollens omgivande ForeColor egenskap.
hWnd Returnerar eller anger kontrollens hWnd egenskap.
Har ingen implementeringstyp för medlemsvariabel .
ReadyState Returnerar eller anger kontrollens ReadyState egenskap.
En kontroll kan vara ennitialiserad, initierad, inläsning, interaktiv eller fullständig.
Mer information finns i READYSTATE i Internet SDK.
Text Returnerar eller anger texten i en kontroll.
Har ingen implementeringstyp för medlemsvariabel .

Se även

Lägg till egenskap

Lägg till IDL-egenskap