Een IDL-eigenschap toevoegen

De wizard IdL-eigenschap toevoegen voegt een eigenschap toe aan een interface die is gedefinieerd in een Interface Definition Library (IDL), zoals in een ATL-project dat een .idl bestand bevat. Deze wizard is niet beschikbaar in projecten die MFC ondersteunen.

Deze wizard verschilt van de wizard Eigenschap toevoegen en wizard IDL MFC-eigenschap toevoegen op de volgende manieren:

• De wizard Eigenschap toevoegen voegt een eigenschap toe aan een interface in uw project.
• De wizard IdL MFC-eigenschap toevoegen is specifiek voor MFC-, ActiveX- of ATL-projecten die MFC ondersteunen.

Een IDL-eigenschap toevoegen

1. Selecteer Klasseweergave in het menu Beeld.

2. Klik in de klasseweergave met de rechtermuisknop op de naam van de interface waaraan u de eigenschap wilt toevoegen.

   Opmerking

   U kunt ook eigenschappen toevoegen aan dispinterfaces, die, tenzij het project van attributen is voorzien, binnen het bibliotheekknooppunt zijn genest.

3. Klik met de rechtermuisknop op de naam van de interface.

4. Selecteer in het snelmenu Toevoegen>Eigenschap Toevoegen.

5. Geef in de wizard IdL-eigenschap toevoegen de informatie op om de eigenschap te maken.

6. Selecteer OK om de eigenschap toe te voegen.

De Get en Put methoden van de eigenschap worden weergegeven als twee pictogrammen in de klasseweergave onder de interface waar deze is gedefinieerd. Dubbelklik op een van de pictogrammen om de eigenschapsdeclaratie in het .idl bestand weer te geven.

Voor ATL-interfaces worden de Get en Put functies toegevoegd aan de .cpp en .h bestanden.

Een wizard voor het toevoegen van een IDL-eigenschap toevoegen

In de volgende sectie wordt de gebruikersinterface beschreven die u gaat gebruiken om een IDL-eigenschap toe te voegen:

• Eigenschapsnaam

  Hiermee stelt u de naam van de eigenschap in.

• Eigenschapstype

  Het gegevenstype van de eigenschap.

• Retour type

  Voor ATL-interfaces stelt u het retourtype voor de eigenschap in. Voor dubbele interfaces is HRESULT altijd het retourtype en is de optie om te selecteren niet beschikbaar. Voor aangepaste interfaces kunt u een retourtype selecteren in de lijst. HRESULT wordt nog steeds aanbevolen, omdat het een standaardmethode biedt om fouten te retourneren.

• Functie opvragen

  Voor ATL-interfaces maakt u de Get methode voor het ophalen van de eigenschapswaarde. Kies Ophalen, Plaatsen of beide.

• Put-functie

  Voor ATL-interfaces maakt u de methode voor het Put instellen van de eigenschapswaarde. Kies Ophalen, Plaatsen of beide. Als u de functie Put selecteert, kunt u kiezen uit de volgende twee manieren om de methode te implementeren:

  Optie	Beschrijving
  propput	De PropPut functie retourneert een kopie van het object. propput is de standaardinstelling en de meest voorkomende manier om de eigenschap beschrijfbaar te maken.
  propputref	De PropPutRef functie retourneert een verwijzing naar het object, in plaats van de kopie van het object zelf te retourneren. Overweeg het gebruik van de propputref optie voor objecten, zoals grote structs of arrays, die mogelijk initialisatiekosten met zich meebrengen.

• Parameters

  Geeft de lijst weer met parameters die aan de eigenschap zijn toegevoegd. Elk item in de lijst bestaat uit de parameternaam, het parametertype en de kenmerken.

  in geeft aan dat de parameter wordt doorgegeven van de aanroepende procedure naar de aangeroepen procedure. out geeft aan dat de aanwijzerparameter wordt geretourneerd van de aangeroepen procedure naar de aanroepende procedure (van de server naar de client).

• +

  Voeg een parameter toe. Typ in Parameters het parametertype en de naam. Selecteer bijvoorbeeld int xOK.

• x

  Hiermee verwijdert u de geselecteerde parameter uit Parameters.

• Potloodpictogram

  De geselecteerde parameter bewerken.

• Kenmerken

1. helpcontext

   Hiermee geeft u een context-id op waarmee de gebruiker informatie over deze eigenschap kan weergeven in het Help-bestand. Zie helpcontext voor meer informatie.

2. helpstring

   Hiermee geeft u een tekenreeks op die wordt gebruikt om het element te beschrijven waarop het van toepassing is. Deze is standaard ingesteld op propertyeigenschapsnaam. Zie helpstring voor meer informatie.

3. id

   Hiermee stelt u de numerieke id in waarmee de eigenschap wordt geïdentificeerd. Deze optie is niet beschikbaar voor eigenschappen van aangepaste interfaces. Zie id voor meer informatie.

• Aanvullende kenmerken

Trefwoorden in de Microsoft Interface Definition Language (MIDL) worden gedetailleerd beschreven in de naslaginformatie over DE MIDL-taal.

Zie ook

Eigenschap toevoegen
IdL MFC-eigenschap toevoegen