Skip to content

Commit 10c0bff

Browse files
committed
Merging changes synced from https://github.com/MicrosoftDocs/cpp-docs-pr (branch live)
2 parents 508c901 + a1676bf commit 10c0bff

File tree

451 files changed

+1174
-1117
lines changed

Some content is hidden

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

451 files changed

+1174
-1117
lines changed

docs/atl-mfc-shared/date-type.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ The following points should be noted when working with these date and time forma
4949
> [!CAUTION]
5050
> Note that because 6:00 AM is always represented by a fractional value 0.25 regardless of whether the integer representing the day is positive (after December 30, 1899) or negative (before December 30, 1899), a simple floating point comparison would erroneously sort any DATE representing 6:00 AM on a day earlier than 12/30/1899 as *later* than a DATE representing 7:00 AM on that same day.
5151
52-
More information on issues related to the DATE and `COleDateTime` types can be found under [COleDateTime Class](../atl-mfc-shared/reference/coledatetime-class.md) and [Date and Time: Automation Support](../atl-mfc-shared/date-and-time-automation-support.md).
52+
More information on issues related to the DATE and `COleDateTime` types can be found under [COleDateTime Class](../atl-mfc-shared/reference/coledatetime-class.md) and [Date and Time: Automation Support](./date-and-time.md).
5353

5454
## See also
5555

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

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ The `DATE` type is implemented as a floating-point value. Days are measured from
8484
> [!CAUTION]
8585
> In the table above, although day values become negative before midnight on December 30, 1899, time-of-day values do not. For example, 6:00 AM is always represented by a fractional value 0.25 regardless of whether the integer representing the day is positive (after December 30, 1899) or negative (before December 30, 1899). This means that a simple floating point comparison would erroneously sort a `COleDateTime` representing 6:00 AM on 12/29/1899 as **later** than one representing 7:00 AM on the same day.
8686
87-
The `COleDateTime` class handles dates from January 1, 100, through December 31, 9999. The `COleDateTime` class uses the Gregorian calendar; it does not support Julian dates. `COleDateTime` ignores Daylight Saving Time. (See [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).)
87+
The `COleDateTime` class handles dates from January 1, 100, through December 31, 9999. The `COleDateTime` class uses the Gregorian calendar; it does not support Julian dates. `COleDateTime` ignores Daylight Saving Time. (See [Date and Time: Automation Support](../date-and-time.md).)
8888

8989
> [!NOTE]
9090
> You can use the `%y` format to retrieve a two-digit year only for dates starting at 1900. If you use the `%y` format on a date before 1900, the code generates an ASSERT failure.
@@ -99,7 +99,7 @@ To avoid problems, specify a four-digit date. For example:
9999

100100
Basic arithmetic operations for the `COleDateTime` values use the companion class [COleDateTimeSpan](../../atl-mfc-shared/reference/coledatetimespan-class.md). `COleDateTimeSpan` values define a time interval. The relationship between these classes is similar to the one between [CTime](../../atl-mfc-shared/reference/ctime-class.md) and [CTimeSpan](../../atl-mfc-shared/reference/ctimespan-class.md).
101101

102-
For more information about the `COleDateTime` and `COleDateTimeSpan` classes, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
102+
For more information about the `COleDateTime` and `COleDateTimeSpan` classes, see the article [Date and Time: Automation Support](../date-and-time.md).
103103

104104
## Requirements
105105

@@ -231,7 +231,7 @@ For more information on the `time_t` data type, see the [time](../../c-runtime-l
231231

232232
For more information, see the [SYSTEMTIME](/windows/win32/api/minwinbase/ns-minwinbase-systemtime) and [FILETIME](/windows/win32/api/minwinbase/ns-minwinbase-filetime) structures in the Windows SDK.
233233

234-
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
234+
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
235235

236236
> [!NOTE]
237237
> The constructor using `DBTIMESTAMP` parameter is only available when OLEDB.h is included.
@@ -617,7 +617,7 @@ Valid return values range between 0 and 59.
617617
> [!NOTE]
618618
> The `COleDateTime` class does not support leap seconds.
619619
620-
For more information about the implementation for `COleDateTime`, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
620+
For more information about the implementation for `COleDateTime`, see the article [Date and Time: Automation Support](../date-and-time.md).
621621

622622
For information on other member functions that query the value of this `COleDateTime` object, see the following member functions:
623623

@@ -699,7 +699,7 @@ For more information about the operations that may set the status to invalid, se
699699

700700
- [operator +=, -=](#operator_add_eq_-_eq)
701701

702-
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
702+
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
703703

704704
### Example
705705

@@ -737,7 +737,7 @@ For information on other member functions that query the value of this `COleDate
737737

738738
- [GetDayOfYear](#getdayofyear)
739739

740-
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
740+
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
741741

742742
### Example
743743

@@ -756,7 +756,7 @@ DATE m_dt;
756756
> [!CAUTION]
757757
> Changing the value in the `DATE` object accessed by the pointer returned by this function will change the value of this `COleDateTime` object. It does not change the status of this `COleDateTime` object.
758758
759-
For more information about the implementation of the `DATE` object, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
759+
For more information about the implementation of the `DATE` object, see the article [Date and Time: Automation Support](../date-and-time.md).
760760

761761
## <a name="m_status"></a> COleDateTime::m_status
762762

@@ -811,7 +811,7 @@ For more information on the `time_t` data type, see the [time](../../c-runtime-l
811811

812812
For more information, see the [SYSTEMTIME](/windows/win32/api/minwinbase/ns-minwinbase-systemtime) and [FILETIME](/windows/win32/api/minwinbase/ns-minwinbase-filetime) structures in the Windows SDK.
813813

814-
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
814+
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
815815

816816
## <a name="operator_add_-"></a> COleDateTime::operator +, -
817817

@@ -837,7 +837,7 @@ The **+** and **-** operators will assert if the `COleDateTime` object is set to
837837

838838
For more information on the valid, invalid, and null status values, see the [m_status](#m_status) member variable.
839839

840-
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
840+
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
841841

842842
### Example
843843

@@ -864,7 +864,7 @@ For more information on the valid, invalid, and null status values, see the [m_s
864864

865865
The **+=** and **-=** operators will assert if the `COleDateTime` object is set to null. See [COleDateTime Relational Operators](#coledatetime_relational_operators) for an example.
866866

867-
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
867+
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
868868

869869
## <a name="operator_date"></a> COleDateTime::operator DATE
870870

@@ -876,7 +876,7 @@ operator DATE() const throw();
876876

877877
### Remarks
878878

879-
This operator returns a `DATE` object whose value is copied from this `COleDateTime` object. For more information about the implementation of the `DATE` object, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
879+
This operator returns a `DATE` object whose value is copied from this `COleDateTime` object. For more information about the implementation of the `DATE` object, see the article [Date and Time: Automation Support](../date-and-time.md).
880880

881881
The `DATE` operator will assert if the `COleDateTime` object is set to null. See [COleDateTime Relational Operators](#coledatetime_relational_operators) for an example.
882882

@@ -939,7 +939,7 @@ In the case of VAR_DATEVALUEONLY, the time value is set to time 0, or midnight.
939939

940940
If the string could not be converted to a date/time value or if there was a numerical overflow, the status of this `COleDateTime` object is invalid.
941941

942-
For more information about the bounds and implementation for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
942+
For more information about the bounds and implementation for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
943943

944944
## <a name="setdate"></a> COleDateTime::SetDate
945945

@@ -1012,7 +1012,7 @@ For information on member functions that query the value of this `COleDateTime`
10121012

10131013
- [GetDayOfYear](#getdayofyear)
10141014

1015-
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
1015+
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
10161016

10171017
### Example
10181018

@@ -1096,7 +1096,7 @@ For information on member functions that query the value of this `COleDateTime`
10961096

10971097
- [GetDayOfYear](#getdayofyear)
10981098

1099-
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
1099+
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
11001100

11011101
### Example
11021102

@@ -1189,7 +1189,7 @@ For information on member functions that query the value of this `COleDateTime`
11891189
11901190
- [GetDayOfYear](#getdayofyear)
11911191
1192-
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
1192+
For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
11931193
11941194
### Example
11951195

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ A `COleDateTimeSpan` keeps time in days.
6565

6666
`COleDateTimeSpan` is used with its companion class [COleDateTime](../../atl-mfc-shared/reference/coledatetime-class.md). `COleDateTime` encapsulates the `DATE` data type of OLE automation. `COleDateTime` represents absolute time values. All `COleDateTime` calculations involve `COleDateTimeSpan` values. The relation between these classes is analogous to the one between [CTime](../../atl-mfc-shared/reference/ctime-class.md) and [CTimeSpan](../../atl-mfc-shared/reference/ctimespan-class.md).
6767

68-
For more information on the `COleDateTime` and `COleDateTimeSpan` classes, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
68+
For more information on the `COleDateTime` and `COleDateTimeSpan` classes, see the article [Date and Time: Automation Support](../date-and-time.md).
6969

7070
## Requirements
7171

@@ -134,7 +134,7 @@ All of these constructors create new `COleDateTimeSpan` objects initialized to t
134134

135135
The status of the new `COleDateTimeSpan` object is set to valid.
136136

137-
For more information about the bounds for `COleDateTimeSpan` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
137+
For more information about the bounds for `COleDateTimeSpan` values, see the article [Date and Time: Automation Support](../date-and-time.md).
138138

139139
### Example
140140

@@ -375,7 +375,7 @@ The status of a `COleDateTimeSpan` object is invalid in the following cases:
375375

376376
For more information about the operations that may set the status to invalid, see [COleDateTimeSpan::operator +, -](../../atl-mfc-shared/reference/coledatetime-class.md#operator_add_-) and [COleDateTimeSpan::operator +=, -=](../../atl-mfc-shared/reference/coledatetime-class.md#operator_add_eq_-_eq).
377377

378-
For more information about the bounds for `COleDateTimeSpan` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
378+
For more information about the bounds for `COleDateTimeSpan` values, see the article [Date and Time: Automation Support](../date-and-time.md).
379379

380380
## <a name="gettotaldays"></a> COleDateTimeSpan::GetTotalDays
381381

@@ -575,7 +575,7 @@ For more information about the operations that may set the status to invalid, se
575575
> [!CAUTION]
576576
> This data member is for advanced programming situations. You should use the inline member functions [GetStatus](#getstatus) and [SetStatus](#setstatus). See `SetStatus` for further cautions regarding explicitly setting this data member.
577577
578-
For more information about the bounds for `COleDateTimeSpan` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
578+
For more information about the bounds for `COleDateTimeSpan` values, see the article [Date and Time: Automation Support](../date-and-time.md).
579579

580580
## <a name="operator_eq"></a> COleDateTimeSpan::operator =
581581

docs/atl/active-template-library-atl-concepts.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.assetid: a3960991-4d76-4da5-9568-3fa7fde53ff4
88

99
The Active Template Library (ATL) is a set of template-based C++ classes that let you create small, fast Component Object Model (COM) objects. It has special support for key COM features, including stock implementations, dual interfaces, standard COM enumerator interfaces, connection points, tear-off interfaces, and ActiveX controls.
1010

11-
If you do a lot of ATL programming, you will want to learn more about COM and .NET attributes, which is designed to simplify COM programming. For more information, see [Attributed Programming](../windows/attributed-programming-concepts.md). (COM and .NET attributes are not to be confused with the \[\[attribute]] feature in the C++ standard.)
11+
If you do a lot of ATL programming, you will want to learn more about COM and .NET attributes, which is designed to simplify COM programming. For more information, see [Attributed Programming](../windows/attributes/cpp-attributes-com-net.md). (COM and .NET attributes are not to be confused with the \[\[attribute]] feature in the C++ standard.)
1212

1313
## In This Section
1414

@@ -89,7 +89,7 @@ Contains information on the ATL Project Wizard.
8989
[ATL Control Wizard](reference/atl-control-wizard.md)<br/>
9090
Discusses how to add classes.
9191

92-
[Attributed Programming](../windows/attributed-programming-concepts.md)<br/>
92+
[Attributed Programming](../windows/attributes/cpp-attributes-com-net.md)<br/>
9393
Provides an overview on using attributes to simplify COM programming plus a list of links to more detailed topics.
9494

9595
[ATL Class Overview](atl-class-overview.md)<br/>

docs/atl/example-implementing-a-property-page.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ When users want to apply their changes to the objects, the property page site wi
126126

127127
To display this page, you need to create a simple helper object. The helper object will provide a method that simplifies the `OleCreatePropertyFrame` API for displaying a single page connected to a single object. This helper will be designed so that it can be used from Visual Basic.
128128

129-
Use the [Add Class dialog box](../ide/add-class-dialog-box.md) and the [ATL Simple Object Wizard](../atl/reference/atl-simple-object-wizard.md) to generate a new class and use `Helper` as its short name. Once created, add a method as shown in the table below.
129+
Use the [Add Class dialog box](../ide/adding-a-class-visual-cpp.md#add-class-dialog-box) and the [ATL Simple Object Wizard](../atl/reference/atl-simple-object-wizard.md) to generate a new class and use `Helper` as its short name. Once created, add a method as shown in the table below.
130130

131131
|Item|Value|
132132
|----------|-----------|

docs/atl/implementing-a-dialog-box.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ There are two ways to add a dialog box to your ATL project: use the ATL Dialog W
1010

1111
## Adding a Dialog Box with the ATL Dialog Wizard
1212

13-
In the [Add Class dialog box](../ide/add-class-dialog-box.md), select the ATL Dialog object to add a dialog box to your ATL project. Fill in the ATL Dialog Wizard as appropriate and click **Finish**. The wizard adds a class derived from [CAxDialogImpl](../atl/reference/caxdialogimpl-class.md) to your project. Open **Resource View** from the **View** menu, locate your dialog, and double-click it to open it in the resource editor.
13+
In the [Add Class dialog box](../ide/adding-a-class-visual-cpp.md#add-class-dialog-box), select the ATL Dialog object to add a dialog box to your ATL project. Fill in the ATL Dialog Wizard as appropriate and click **Finish**. The wizard adds a class derived from [CAxDialogImpl](../atl/reference/caxdialogimpl-class.md) to your project. Open **Resource View** from the **View** menu, locate your dialog, and double-click it to open it in the resource editor.
1414

1515
> [!NOTE]
1616
> If your dialog box is derived from `CAxDialogImpl`, it can host both ActiveX and Windows controls. If you don't want the overhead of ActiveX control support in your dialog box class, use [CSimpleDialog](../atl/reference/csimpledialog-class.md) or [CDialogImpl](../atl/reference/cdialogimpl-class.md) instead.

docs/atl/implementing-a-dual-interface.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ To use this class:
2222

2323
## ATL Simple Object Wizard
2424

25-
If you want to create a new interface and a new class to implement it, you can use the [ATL Add Class dialog box](../ide/add-class-dialog-box.md), and then the [ATL Simple Object Wizard](../atl/reference/atl-simple-object-wizard.md).
25+
If you want to create a new interface and a new class to implement it, you can use the [ATL Add Class dialog box](../ide/adding-a-class-visual-cpp.md#add-class-dialog-box), and then the [ATL Simple Object Wizard](../atl/reference/atl-simple-object-wizard.md).
2626

2727
## Implement Interface Wizard
2828

docs/atl/implementing-property-pages.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,13 +14,13 @@ The ATL Property Page wizard is not available in Visual Studio 2019 and later.
1414

1515
::: moniker range="<=vs-2017"
1616

17-
Property pages are COM objects that implement the `IPropertyPage` or `IPropertyPage2` interface. ATL provides support for implementing property pages through the [ATL Property Page Wizard](../atl/reference/atl-property-page-wizard.md) in the [Add Class dialog box](../ide/add-class-dialog-box.md).
17+
Property pages are COM objects that implement the `IPropertyPage` or `IPropertyPage2` interface. ATL provides support for implementing property pages through the [ATL Property Page Wizard](../atl/reference/atl-property-page-wizard.md) in the [Add Class dialog box](../ide/adding-a-class-visual-cpp.md#add-class-dialog-box).
1818

1919
To create a property page using ATL:
2020

2121
- Create or open an ATL Dynamic-link library (DLL) server project.
2222

23-
- Open the [Add Class dialog box](../ide/add-class-dialog-box.md) and select **ATL Property Page**.
23+
- Open the [Add Class dialog box](../ide/adding-a-class-visual-cpp.md#add-class-dialog-box) and select **ATL Property Page**.
2424

2525
- Make sure your property page is apartment threaded (since it has a user interface).
2626

0 commit comments

Comments
 (0)