edit pass. Move to ide location

Author: TylerMSFT

docs/mfc/reference/adding-an-idl-property-wizard.md renamed to docs/ide/add-an-idl-property-wizard.md

@@ -1,21 +1,20 @@
 ---
 description: "Learn more about: Use a Microsoft Visual Studio wizard to add an IDL property to an IDL interface in your project"
 title: "Add an IDL property"
-ms.date: "04/07/2022"
+ms.date: 04/08/2022
 f1_keywords: ["vc.codewiz.prop.overview", "vc.codewiz.prop.idlattributes"]
 helpviewer_keywords: ["interfaces, adding properties", "properties [C++], adding to interfaces", "names, add property wizard", "IDL attributes", "stock properties, about stock properties", "stock properties"]
-ms.assetid: 37bd4db7-efd3-4faa-87ad-64902ed16a36
 ms.custom: devdivchpfy22
 ---
 # Add an IDL property
 
-The **Add IDL Property** wizard adds a method to an interface defined in an Interface Definition Library (IDL) in a project that has IDL file. To use the **Add IDL Property** wizard, you must be in a project that doesn't support MFC.
+The **Add IDL Property** wizard adds a method to an interface defined in an Interface Definition Library (IDL). To use the **Add IDL Property** wizard, you're project can't support MFC.
 
-For example, if you have an ATL project, and it has an IDL file, using the following procedure you can add the method to interface.
+For example, if you have an ATL project, and it has an `.idl` file in it, use the following procedure to add a property to an interface.
 
-This wizard differs from the **Add Property** wizard and **Add IDL MFC Property** wizard. The [Add Property](../../ide/adding-a-property-visual-cpp.md) wizard adds a default method to your project. The Add IDL MFC Method wizard is specific to MFC, ActiveX, or ATL projects that support MFC.
+This wizard differs from the **Add Property** wizard and **Add IDL MFC Property** wizard. The [Add Property](adding-a-property-visual-cpp.md) wizard adds a property to your project. The Add IDL MFC Property wizard is specific to MFC, ActiveX, or ATL projects that support MFC.
 
-**To add an IDL property to your object**
+**To add an IDL property**
 
 1. On the **View** menu, select **Class View**.
 
@@ -28,50 +27,51 @@ This wizard differs from the **Add Property** wizard and **Add IDL MFC Property*
 
 1. In the **Add IDL Property** wizard, provide the information to create the property.
 
-1. Specify any IDL settings for the property.
-
 1. Select **OK** to add the property.
 
-The `Get` and `Put` methods of the property are displayed as two icons in **Class View**, under the interface where it's defined. You can double-click either icon to view the property declaration in the .idl file.
+The `Get` and `Put` methods of the property are displayed as two icons in **Class View**, under the interface where it's defined. You can double-click either icon to view the property declaration in the `.idl` file.
 
-For ATL interfaces, the `Get` and `Put` functions are added to the .cpp file, and references to these functions are added to the .h file.
+For ATL interfaces, the `Get` and `Put` functions are added to the `.cpp` and `.h` files.
 
 ## Add an IDL property wizard
 
 The following section describes the UI that you'll use to add an IDL property:
 
-:::image type="content" source="../reference/media/add-idl-property-wizard.png" alt-text="Adding IDL property to the interface":::
+:::image type="content" source="media/add-idl-property-wizard.png" alt-text="Adding IDL property to the interface":::
 
 - **Property name**
 
   Sets the name of the property.
 
 - **Property type**
 
-  Sets the type of property you're adding.
+  Sets whether your property will have a getter, setter, or both.
 
 - **Return type**
 
-  For ATL interfaces, sets the return type for the property. For dual interfaces, `HRESULT` is always the return type, and select option is unavailable. For custom interfaces, you can select a return type from the list. `HRESULT` is still recommended, as it provides a standard way to return errors.
+  For ATL interfaces, sets the return type for the property.
+  For dual interfaces, `HRESULT` is always the return type, and select option is unavailable.
+  For custom interfaces, you can select a return type from the list. `HRESULT` is still recommended, as it provides a standard way to return errors.
 
 - **Get function**
 
-  For ATL interfaces, sets the property as readable. It creates the `Get` method for retrieving property from the object. Select **Get**, **Put**, or both.
+  For ATL interfaces, creates the `Get` method for retrieving the property value. Select **Get**, **Put**, or both.
 
 - **Put function**
 
-  For ATL interfaces, sets the property writable. It creates the `Put` method for setting, or "putting," property of the object. Select **Get**, **Put**, or both. If you select **Put function** option, you can choose from the following two ways to implement the method:
+  For ATL interfaces, creates the `Put` method for setting the property value. Select **Get**, **Put**, or both. If you select **Put function**, you can choose from the following two ways to implement the method:
 
   |Option|Description|
   |------------|-----------------|
-  |**PropPut**|The [PropPut](../../windows/attributes/propput.md) function returns a copy of the object. **PropPut** is the default and the most common way to make the property writable.|
-  |**PropPutRef**|The [PropPutRef](../../windows/attributes/propputref.md) function returns a reference to the object, rather than returning the copy of the object itself. Consider using **PropPutRef** option for objects, such as large structs or arrays, that may have initialization overhead.|
+  |**propput**|The [PropPut](../windows/attributes/propput.md) function returns a copy of the object. **propput** is the default and the most common way to make the property writable.|
+  |**propputref**|The [PropPutRef](../windows/attributes/propputref.md) function returns a reference to the object, rather than returning the copy of the object itself. Consider using **propputref** option for objects, such as large structs or arrays, that may have initialization overhead.|
 
 - **Parameters**
 
   Displays the list of parameters added to the property. Each item in the list consists of the parameter name, parameter type, and attributes.
 
-  The `in` indicates that the parameter is passed from the calling procedure to the called procedure. The `out` indicates that the pointer parameter is returned from the called procedure to the calling procedure (from the server to the client).
+  `in` indicates that the parameter is passed from the calling procedure to the called procedure.
+  `out` indicates that the pointer parameter is returned from the called procedure to the calling procedure (from the server to the client).
 
 - **+**
 
@@ -89,32 +89,34 @@ The following section describes the UI that you'll use to add an IDL property:
 
 1. `helpcontext`
 
-    Specifies a context ID that lets the user view information about this property in the Help file. For more information, see [helpcontext](/windows/win32/Midl/helpcontext) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).
+    Specifies a context ID that lets the user view information about this property in the Help file. For more information, see [helpcontext](/windows/win32/Midl/helpcontext).
 
 1. `helpstring`
 
-    Specifies a character string that's used to describe the element to which it applies. By default, it's set to **`property`** *Property name*. For more information, see [helpstring](/windows/win32/Midl/helpstring) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).
+    Specifies a character string that's used to describe the element to which it applies. By default, it's set to **`property`** *Property name*. For more information, see [helpstring](/windows/win32/Midl/helpstring).
 
 1. `id`
 
-    Sets the numerical ID that identifies the property. This option isn't available for properties of custom interfaces. For more information, see [id](/windows/win32/Midl/id) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).
+    Sets the numerical ID that identifies the property. This option isn't available for properties of custom interfaces. For more information, see [id](/windows/win32/Midl/id).
 
 - **Additional attributes**
 
+Keywords in the Microsoft Interface Definition Language (MIDL) are described in detail in the [MIDL language reference](/windows/win32/midl/midl-language-reference.md).
+
   |Option|Description|
   |------------|-----------------|
-  |`bindable`|Indicates that the property supports data binding. For more information, see [bindable](/windows/win32/Midl/bindable) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).|
-  |`defaultbind`|Indicates that this single, bindable property best represents the object. For more information, see [defaultbind](/windows/win32/Midl/defaultbind) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).|
-  |`defaultcollelem`|Indicates that the property is an accessor function for an element of the default collection. For more information, see [defaultcollelem](/windows/win32/Midl/defaultcollelem) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).|
-  |`displaybind`|Indicates that this property should be displayed to the user as bindable. For more information, see [displaybind](/windows/win32/Midl/displaybind) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).|
-  |`hidden`|Indicates that the property exists but shouldn't be displayed in a user-oriented browser. For more information, see [hidden](/windows/win32/Midl/hidden) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).|
-  |`immediatebind`|Indicates that the database will be notified immediately of all changes to this property of a data-bound object. For more information, see [immediatebind](/windows/win32/Midl/immediatebind) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).|
-  |`local`|Specifies to the MIDL compiler that the property isn't remote. For more information, see [local](/windows/win32/Midl/local) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).|
-  |`nonbrowsable`|Tags an interface or dispinterface member that shouldn't be displayed in a properties browser. For more information, see [nonbrowsable](/windows/win32/Midl/nonbrowsable) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).|
-  |`requestedit`|Indicates that the property supports the `OnRequestEdit` notification. For more information, see [requestedit](/windows/win32/Midl/requestedit) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).|
-  |`restricted`|Specifies that the property can't be called arbitrarily. For more information, see [restricted](/windows/win32/Midl/restricted) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).|
-  |`source`|Indicates that a member of the property is a source of events. For more information, see [source](/windows/win32/Midl/source) in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).|
+  |`bindable`|Indicates that the property supports data binding. For more information, see [bindable](/windows/win32/Midl/bindable).|
+  |`defaultbind`|Indicates that this single, bindable property best represents the object. For more information, see [defaultbind](/windows/win32/Midl/defaultbind).|
+  |`defaultcollelem`|Indicates that the property is an accessor function for an element of the default collection. For more information, see [defaultcollelem](/windows/win32/Midl/defaultcollelem).|
+  |`displaybind`|Indicates that this property should be displayed to the user as bindable. For more information, see [displaybind](/windows/win32/Midl/displaybind).|
+  |`hidden`|Indicates that the property exists but shouldn't be displayed in the a user-oriented browser. For more information, see [hidden](/windows/win32/Midl/hidden).|
+  |`immediatebind`|Indicates that the database will be notified immediately of all changes to this property of a data-bound object. For more information, see [immediatebind](/windows/win32/Midl/immediatebind).|
+  |`local`|Specifies to the MIDL compiler that the property isn't remote. For more information, see [local](/windows/win32/Midl/local).|
+  |`nonbrowsable`|Tags an interface or dispinterface member that shouldn't be displayed in a properties browser. For more information, see [nonbrowsable](/windows/win32/Midl/nonbrowsable).|
+  |`requestedit`|Indicates that the property supports the `OnRequestEdit` notification. For more information, see [requestedit](/windows/win32/Midl/requestedit).|
+  |`restricted`|Specifies that the property can't be called arbitrarily. For more information, see [restricted](/windows/win32/Midl/restricted).|
+  |`source`|Indicates that a member of the property is a source of events. For more information, see [source](/windows/win32/Midl/source).|
 
 ## **See also**
 
-[Add Property](../../ide/adding-a-property-visual-cpp.md)
+[Add Property](adding-a-property-visual-cpp.md)

docs/mfc/reference/media/add-idl-property-wizard.png renamed to docs/ide/media/add-idl-property-wizard.png

@@ -80,6 +80,8 @@ items:
       href: ../ide/adding-a-method-visual-cpp.md
     - name: Add a property
       href: ../ide/adding-a-property-visual-cpp.md
+    - name: Add an IDL property
+      href: ../ide/adding-a-property-visual-cpp.md
     - name: Add an event
       href: ../ide/adding-an-event-visual-cpp.md
     - name: Add an event handler