Skip to content

Commit a9e791c

Browse files
author
Michael Blome
committed
fixed line endings
1 parent 1bf1353 commit a9e791c

File tree

97 files changed

+9460
-9460
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

97 files changed

+9460
-9460
lines changed

docs/atl-mfc-shared/reference/coledatetime-class.md

+1,104-1,104
Large diffs are not rendered by default.
+42-42
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,42 @@
1-
---
2-
title: "ATL Collections and Enumerators | Microsoft Docs"
3-
ms.custom: ""
4-
ms.date: "11/04/2016"
5-
ms.technology: ["cpp-atl"]
6-
ms.topic: "conceptual"
7-
dev_langs: ["C++"]
8-
helpviewer_keywords: ["enumerator interfaces", "collections, ATL classes", "enumerators, ATL classes", "collection interfaces"]
9-
ms.assetid: b2d37119-3ab2-4e0a-b65b-f377f07e4098
10-
author: "mikeblome"
11-
ms.author: "mblome"
12-
ms.workload: ["cplusplus"]
13-
---
14-
# ATL Collections and Enumerators
15-
A `collection` is a COM object that provides an interface that allows access to a group of data items (raw data or other objects). An interface that follows the standards for providing access to a group of objects is known as a *collection interface*.
16-
17-
At a minimum, collection interfaces must provide a **Count** property that returns the number of items in the collection, an **Item** property that returns an item from the collection based on an index, and a `_NewEnum` property that returns an enumerator for the collection. Optionally, collection interfaces can provide **Add** and **Remove** methods to allow items to be inserted into or deleted from the collection, and a **Clear** method to remove all items.
18-
19-
An `enumerator` is a COM object that provides an interface for iterating through items in a collection. Enumerator interfaces provide serial access to the elements of a collection via four required methods: `Next`, **Skip**, **Reset**, and `Clone`.
20-
21-
You can learn more about enumerator interfaces by reading about the archetypal (but entirely imaginary) [IEnumXXXX](https://msdn.microsoft.com/library/ms680089.aspx) interface.
22-
23-
## In This Section
24-
[ATL Collection and Enumerator Classes](../atl/atl-collection-and-enumerator-classes.md)
25-
Briefly describes and provides links to the ATL classes that will help you implement collections and enumerators.
26-
27-
[Design Principles for Collection and Enumerator Interfaces](../atl/design-principles-for-collection-and-enumerator-interfaces.md)
28-
Discusses the different design principles behind each type of interface.
29-
30-
[Implementing a C++ Standard Library-Based Collection](../atl/implementing-an-stl-based-collection.md)
31-
An extended example that walks you through the implementation of a C++ Standard Library-based collection.
32-
33-
## Related Sections
34-
[ATL](../atl/active-template-library-atl-concepts.md)
35-
Provides links to conceptual topics on how to program using the Active Template Library.
36-
37-
[ATLCollections Sample](../visual-cpp-samples.md)
38-
A sample that demonstrates the use of `ICollectionOnSTLImpl` and `CComEnumOnSTL`, and the implementation of custom copy policy classes.
39-
40-
## See Also
41-
[Concepts](../atl/active-template-library-atl-concepts.md)
42-
1+
---
2+
title: "ATL Collections and Enumerators | Microsoft Docs"
3+
ms.custom: ""
4+
ms.date: "11/04/2016"
5+
ms.technology: ["cpp-atl"]
6+
ms.topic: "conceptual"
7+
dev_langs: ["C++"]
8+
helpviewer_keywords: ["enumerator interfaces", "collections, ATL classes", "enumerators, ATL classes", "collection interfaces"]
9+
ms.assetid: b2d37119-3ab2-4e0a-b65b-f377f07e4098
10+
author: "mikeblome"
11+
ms.author: "mblome"
12+
ms.workload: ["cplusplus"]
13+
---
14+
# ATL Collections and Enumerators
15+
A `collection` is a COM object that provides an interface that allows access to a group of data items (raw data or other objects). An interface that follows the standards for providing access to a group of objects is known as a *collection interface*.
16+
17+
At a minimum, collection interfaces must provide a **Count** property that returns the number of items in the collection, an **Item** property that returns an item from the collection based on an index, and a `_NewEnum` property that returns an enumerator for the collection. Optionally, collection interfaces can provide **Add** and **Remove** methods to allow items to be inserted into or deleted from the collection, and a **Clear** method to remove all items.
18+
19+
An `enumerator` is a COM object that provides an interface for iterating through items in a collection. Enumerator interfaces provide serial access to the elements of a collection via four required methods: `Next`, **Skip**, **Reset**, and `Clone`.
20+
21+
You can learn more about enumerator interfaces by reading about the archetypal (but entirely imaginary) [IEnumXXXX](https://msdn.microsoft.com/library/ms680089.aspx) interface.
22+
23+
## In This Section
24+
[ATL Collection and Enumerator Classes](../atl/atl-collection-and-enumerator-classes.md)
25+
Briefly describes and provides links to the ATL classes that will help you implement collections and enumerators.
26+
27+
[Design Principles for Collection and Enumerator Interfaces](../atl/design-principles-for-collection-and-enumerator-interfaces.md)
28+
Discusses the different design principles behind each type of interface.
29+
30+
[Implementing a C++ Standard Library-Based Collection](../atl/implementing-an-stl-based-collection.md)
31+
An extended example that walks you through the implementation of a C++ Standard Library-based collection.
32+
33+
## Related Sections
34+
[ATL](../atl/active-template-library-atl-concepts.md)
35+
Provides links to conceptual topics on how to program using the Active Template Library.
36+
37+
[ATLCollections Sample](../visual-cpp-samples.md)
38+
A sample that demonstrates the use of `ICollectionOnSTLImpl` and `CComEnumOnSTL`, and the implementation of custom copy policy classes.
39+
40+
## See Also
41+
[Concepts](../atl/active-template-library-atl-concepts.md)
42+
+50-50
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,50 @@
1-
---
2-
title: "ATL COM Desktop Components | Microsoft Docs"
3-
ms.custom: ""
4-
ms.date: "11/04/2016"
5-
ms.technology: ["cpp-atl"]
6-
ms.topic: "conceptual"
7-
dev_langs: ["C++"]
8-
helpviewer_keywords: ["ATL, reference", "ATL, about ATL"]
9-
ms.assetid: 291f38d1-d2de-4687-86a9-99b4fd35706c
10-
author: "mikeblome"
11-
ms.author: "mblome"
12-
ms.workload: ["cplusplus"]
13-
---
14-
# ATL COM Desktop Components
15-
The ATL Reference documents the Active Template Library (ATL), a set of template-based C++ classes that simplify the programming of Component Object Model (COM) objects. To fully take advantage of ATL, a working familiarity with COM is highly recommended.
16-
17-
## In This Section
18-
[ATL Class Overview](../atl/atl-class-overview.md)
19-
Provides links to and brief descriptions of the ATL classes organized by category.
20-
21-
[ATL Classes and structs](../atl/reference/atl-classes.md)
22-
Provides reference material on the classes and structs organized alphabetically.
23-
24-
[ATL Functions](../atl/reference/atl-functions.md)
25-
Provides reference material on the global functions organized alphabetically. Includes topics organizing the functions into categories.
26-
27-
[ATL Global Variables](../atl/reference/atl-global-variables.md)
28-
Provides reference material on the global variables organized alphabetically.
29-
30-
[ATL Macros](../atl/reference/atl-macros.md)
31-
Provides reference material on the macros organized alphabetically. Includes topics organizing the macros into categories.
32-
33-
[ATL Typedefs](../atl/reference/atl-typedefs.md)
34-
Provides reference material on the typedefs organized alphabetically
35-
36-
[Worker Archetype](../atl/reference/worker-archetype.md)
37-
Provides a links to the ATL Worker archetype.
38-
39-
## Related Sections
40-
[ATL](../atl/active-template-library-atl-concepts.md)
41-
Provides topics on how to program using the Active Template Library (ATL).
42-
43-
[ATL Tutorial](../atl/active-template-library-atl-tutorial.md)
44-
Leads you through the creation of a control and demonstrates some ATL fundamentals in the process.
45-
46-
[ATL Samples](../visual-cpp-samples.md)
47-
Sample code that shows how to use ATL to write COM objects.
48-
49-
[OLE DB Templates](../data/oledb/ole-db-templates.md)
50-
Provides reference material for the OLE DB consumer and provider templates, a set of template classes that implement many commonly used OLE DB interfaces.
1+
---
2+
title: "ATL COM Desktop Components | Microsoft Docs"
3+
ms.custom: ""
4+
ms.date: "11/04/2016"
5+
ms.technology: ["cpp-atl"]
6+
ms.topic: "conceptual"
7+
dev_langs: ["C++"]
8+
helpviewer_keywords: ["ATL, reference", "ATL, about ATL"]
9+
ms.assetid: 291f38d1-d2de-4687-86a9-99b4fd35706c
10+
author: "mikeblome"
11+
ms.author: "mblome"
12+
ms.workload: ["cplusplus"]
13+
---
14+
# ATL COM Desktop Components
15+
The ATL Reference documents the Active Template Library (ATL), a set of template-based C++ classes that simplify the programming of Component Object Model (COM) objects. To fully take advantage of ATL, a working familiarity with COM is highly recommended.
16+
17+
## In This Section
18+
[ATL Class Overview](../atl/atl-class-overview.md)
19+
Provides links to and brief descriptions of the ATL classes organized by category.
20+
21+
[ATL Classes and structs](../atl/reference/atl-classes.md)
22+
Provides reference material on the classes and structs organized alphabetically.
23+
24+
[ATL Functions](../atl/reference/atl-functions.md)
25+
Provides reference material on the global functions organized alphabetically. Includes topics organizing the functions into categories.
26+
27+
[ATL Global Variables](../atl/reference/atl-global-variables.md)
28+
Provides reference material on the global variables organized alphabetically.
29+
30+
[ATL Macros](../atl/reference/atl-macros.md)
31+
Provides reference material on the macros organized alphabetically. Includes topics organizing the macros into categories.
32+
33+
[ATL Typedefs](../atl/reference/atl-typedefs.md)
34+
Provides reference material on the typedefs organized alphabetically
35+
36+
[Worker Archetype](../atl/reference/worker-archetype.md)
37+
Provides a links to the ATL Worker archetype.
38+
39+
## Related Sections
40+
[ATL](../atl/active-template-library-atl-concepts.md)
41+
Provides topics on how to program using the Active Template Library (ATL).
42+
43+
[ATL Tutorial](../atl/active-template-library-atl-tutorial.md)
44+
Leads you through the creation of a control and demonstrates some ATL fundamentals in the process.
45+
46+
[ATL Samples](../visual-cpp-samples.md)
47+
Sample code that shows how to use ATL to write COM objects.
48+
49+
[OLE DB Templates](../data/oledb/ole-db-templates.md)
50+
Provides reference material for the OLE DB consumer and provider templates, a set of template classes that implement many commonly used OLE DB interfaces.
+51-51
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,51 @@
1-
---
2-
title: "ATL Support for DHTML Controls | Microsoft Docs"
3-
ms.custom: ""
4-
ms.date: "11/04/2016"
5-
ms.technology: ["cpp-atl"]
6-
ms.topic: "conceptual"
7-
dev_langs: ["C++"]
8-
helpviewer_keywords: ["HTML controls, ATL support", "DHTML controls, ATL support", "DHTML controls"]
9-
ms.assetid: 4ba98098-da5d-4362-96ad-8372f816c307
10-
author: "mikeblome"
11-
ms.author: "mblome"
12-
ms.workload: ["cplusplus"]
13-
---
14-
# ATL Support for DHTML Controls
15-
Using ATL, you can create a control with Dynamic HTML (DHTML) capability. An ATL DHTML control:
16-
17-
- Hosts the WebBrowser control.
18-
19-
- Specifies, using HTML, the user interface (UI) of the DHTML control.
20-
21-
- Accesses the WebBrowser object and its methods through its interface, [IWebBrowser2](https://msdn.microsoft.com/library/aa752127.aspx).
22-
23-
- Manages communication between C++ code and HTML.
24-
25-
A DHTML control is similar to any other ATL control, except the DHTML control includes an additional dispatch interface. See the figure in [Identifying the Elements of the DHTML Control Project](../atl/identifying-the-elements-of-the-dhtml-control-project.md) for an illustration of the interfaces provided in the default DHTML project.
26-
27-
You can view the ATL DHTML control in a Web browser or other container, such as the ActiveX Control Test Container.
28-
29-
## In This Section
30-
[Identifying the Elements of the DHTML Control Project](../atl/identifying-the-elements-of-the-dhtml-control-project.md)
31-
Describes the elements of a DHTML control project.
32-
33-
[Calling C++ Code from DHTML](../atl/calling-cpp-code-from-dhtml.md)
34-
Provides an example of calling C++ code from a DHTML control.
35-
36-
[Creating an ATL DHTML Control](../atl/creating-an-atl-dhtml-control.md)
37-
Lists the steps for creating a DHTML control.
38-
39-
[Testing the ATL DHTML Control](../atl/testing-the-atl-dhtml-control.md)
40-
Shows how to build and test the initial DHTML control project.
41-
42-
[Modifying the ATL DHTML Control](../atl/modifying-the-atl-dhtml-control.md)
43-
Shows how to add some functionality to the control.
44-
45-
[Testing the Altered ATL DHTML Control](../atl/testing-the-modified-atl-dhtml-control.md)
46-
Shows how to build and test the control's added functionality.
47-
48-
## Related Sections
49-
[ATL](../atl/active-template-library-atl-concepts.md)
50-
Provides links to conceptual topics on how to program using the Active Template Library.
51-
1+
---
2+
title: "ATL Support for DHTML Controls | Microsoft Docs"
3+
ms.custom: ""
4+
ms.date: "11/04/2016"
5+
ms.technology: ["cpp-atl"]
6+
ms.topic: "conceptual"
7+
dev_langs: ["C++"]
8+
helpviewer_keywords: ["HTML controls, ATL support", "DHTML controls, ATL support", "DHTML controls"]
9+
ms.assetid: 4ba98098-da5d-4362-96ad-8372f816c307
10+
author: "mikeblome"
11+
ms.author: "mblome"
12+
ms.workload: ["cplusplus"]
13+
---
14+
# ATL Support for DHTML Controls
15+
Using ATL, you can create a control with Dynamic HTML (DHTML) capability. An ATL DHTML control:
16+
17+
- Hosts the WebBrowser control.
18+
19+
- Specifies, using HTML, the user interface (UI) of the DHTML control.
20+
21+
- Accesses the WebBrowser object and its methods through its interface, [IWebBrowser2](https://msdn.microsoft.com/library/aa752127.aspx).
22+
23+
- Manages communication between C++ code and HTML.
24+
25+
A DHTML control is similar to any other ATL control, except the DHTML control includes an additional dispatch interface. See the figure in [Identifying the Elements of the DHTML Control Project](../atl/identifying-the-elements-of-the-dhtml-control-project.md) for an illustration of the interfaces provided in the default DHTML project.
26+
27+
You can view the ATL DHTML control in a Web browser or other container, such as the ActiveX Control Test Container.
28+
29+
## In This Section
30+
[Identifying the Elements of the DHTML Control Project](../atl/identifying-the-elements-of-the-dhtml-control-project.md)
31+
Describes the elements of a DHTML control project.
32+
33+
[Calling C++ Code from DHTML](../atl/calling-cpp-code-from-dhtml.md)
34+
Provides an example of calling C++ code from a DHTML control.
35+
36+
[Creating an ATL DHTML Control](../atl/creating-an-atl-dhtml-control.md)
37+
Lists the steps for creating a DHTML control.
38+
39+
[Testing the ATL DHTML Control](../atl/testing-the-atl-dhtml-control.md)
40+
Shows how to build and test the initial DHTML control project.
41+
42+
[Modifying the ATL DHTML Control](../atl/modifying-the-atl-dhtml-control.md)
43+
Shows how to add some functionality to the control.
44+
45+
[Testing the Altered ATL DHTML Control](../atl/testing-the-modified-atl-dhtml-control.md)
46+
Shows how to build and test the control's added functionality.
47+
48+
## Related Sections
49+
[ATL](../atl/active-template-library-atl-concepts.md)
50+
Provides links to conceptual topics on how to program using the Active Template Library.
51+

docs/atl/class-factories-classes.md

+31-31
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,31 @@
1-
---
2-
title: " ATL Class Factories Classes | Microsoft Docs"
3-
ms.custom: ""
4-
ms.date: "11/04/2016"
5-
ms.technology: ["cpp-atl"]
6-
ms.topic: "reference"
7-
f1_keywords: ["vc.atl.classes.factories"]
8-
dev_langs: ["C++"]
9-
helpviewer_keywords: ["class factories", "class factories, ATL classes"]
10-
ms.assetid: 1d8c2ae2-2c37-452c-a02d-1ecbdd309f84
11-
author: "mikeblome"
12-
ms.author: "mblome"
13-
ms.workload: ["cplusplus"]
14-
---
15-
# Class Factories Classes
16-
The following classes implement or support a class factory:
17-
18-
- [CComClassFactory](../atl/reference/ccomclassfactory-class.md) Provides a default class factory for object creation.
19-
20-
- [CComClassFactory2](../atl/reference/ccomclassfactory2-class.md) Controls object creation through a license.
21-
22-
- [CComClassFactoryAutoThread](../atl/reference/ccomclassfactoryautothread-class.md) Allows objects to be created in multiple thread-pooled apartments.
23-
24-
- [CComClassFactorySingleton](../atl/reference/ccomclassfactorysingleton-class.md) Creates a single object.
25-
26-
- [CComCoClass](../atl/reference/ccomcoclass-class.md) Defines the class factory for the object.
27-
28-
## See Also
29-
[Class Overview](../atl/atl-class-overview.md)
30-
[Aggregation and Class Factory Macros](../atl/reference/aggregation-and-class-factory-macros.md)
31-
1+
---
2+
title: " ATL Class Factories Classes | Microsoft Docs"
3+
ms.custom: ""
4+
ms.date: "11/04/2016"
5+
ms.technology: ["cpp-atl"]
6+
ms.topic: "reference"
7+
f1_keywords: ["vc.atl.classes.factories"]
8+
dev_langs: ["C++"]
9+
helpviewer_keywords: ["class factories", "class factories, ATL classes"]
10+
ms.assetid: 1d8c2ae2-2c37-452c-a02d-1ecbdd309f84
11+
author: "mikeblome"
12+
ms.author: "mblome"
13+
ms.workload: ["cplusplus"]
14+
---
15+
# Class Factories Classes
16+
The following classes implement or support a class factory:
17+
18+
- [CComClassFactory](../atl/reference/ccomclassfactory-class.md) Provides a default class factory for object creation.
19+
20+
- [CComClassFactory2](../atl/reference/ccomclassfactory2-class.md) Controls object creation through a license.
21+
22+
- [CComClassFactoryAutoThread](../atl/reference/ccomclassfactoryautothread-class.md) Allows objects to be created in multiple thread-pooled apartments.
23+
24+
- [CComClassFactorySingleton](../atl/reference/ccomclassfactorysingleton-class.md) Creates a single object.
25+
26+
- [CComCoClass](../atl/reference/ccomcoclass-class.md) Defines the class factory for the object.
27+
28+
## See Also
29+
[Class Overview](../atl/atl-class-overview.md)
30+
[Aggregation and Class Factory Macros](../atl/reference/aggregation-and-class-factory-macros.md)
31+

docs/atl/class-information-classes.md

+22-22
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,22 @@
1-
---
2-
title: "Class Information Classes (ATL) | Microsoft Docs"
3-
ms.custom: ""
4-
ms.date: "11/04/2016"
5-
ms.technology: ["cpp-atl"]
6-
ms.topic: "reference"
7-
f1_keywords: ["vc.atl.classes.info"]
8-
dev_langs: ["C++"]
9-
helpviewer_keywords: ["class information, retrieving"]
10-
ms.assetid: 39365025-f24a-41ae-87ab-4ae8ed085b98
11-
author: "mikeblome"
12-
ms.author: "mblome"
13-
ms.workload: ["cplusplus"]
14-
---
15-
# Class Information Classes
16-
The following class provides support for retrieving class information:
17-
18-
- [IProvideClassInfo2Impl](../atl/reference/iprovideclassinfo2impl-class.md) Provides access to type information. Retrieves the outgoing IID for the object's default event set.
19-
20-
## See Also
21-
[Class Overview](../atl/atl-class-overview.md)
22-
1+
---
2+
title: "Class Information Classes (ATL) | Microsoft Docs"
3+
ms.custom: ""
4+
ms.date: "11/04/2016"
5+
ms.technology: ["cpp-atl"]
6+
ms.topic: "reference"
7+
f1_keywords: ["vc.atl.classes.info"]
8+
dev_langs: ["C++"]
9+
helpviewer_keywords: ["class information, retrieving"]
10+
ms.assetid: 39365025-f24a-41ae-87ab-4ae8ed085b98
11+
author: "mikeblome"
12+
ms.author: "mblome"
13+
ms.workload: ["cplusplus"]
14+
---
15+
# Class Information Classes
16+
The following class provides support for retrieving class information:
17+
18+
- [IProvideClassInfo2Impl](../atl/reference/iprovideclassinfo2impl-class.md) Provides access to type information. Retrieves the outgoing IID for the object's default event set.
19+
20+
## See Also
21+
[Class Overview](../atl/atl-class-overview.md)
22+

0 commit comments

Comments
 (0)