Skip to content

Commit e8e9fd9

Browse files
authored
Merge pull request MicrosoftDocs#1011 from msebolt/format-mfc-reference-pr18
format mfc reference pr18
2 parents 680c014 + d027576 commit e8e9fd9

15 files changed

+428
-431
lines changed

docs/mfc/reference/run-time-object-model-services.md

Lines changed: 45 additions & 45 deletions
Large diffs are not rendered by default.

docs/mfc/reference/sockaddr-in-structure.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ struct in_addr sin_addr;
2828

2929
#### Parameters
3030
*sin_family*
31-
Address family (must be **AF_INET**).
31+
Address family (must be AF_INET).
3232

3333
*sin_port*
3434
IP port.
@@ -42,7 +42,7 @@ struct in_addr sin_addr;
4242
## Remarks
4343
This is the form of the `SOCKADDR` structure specific to the Internet address family and can be cast to `SOCKADDR`.
4444

45-
The IP address component of this structure is of type **IN_ADDR**. The **IN_ADDR** structure is defined in Windows Sockets header file WINSOCK.H as follows:
45+
The IP address component of this structure is of type `IN_ADDR`. The `IN_ADDR` structure is defined in Windows Sockets header file WINSOCK.H as follows:
4646

4747
```
4848
struct in_addr {

docs/mfc/reference/standard-command-and-window-ids.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,15 @@ ms.author: "mblome"
1313
ms.workload: ["cplusplus"]
1414
---
1515
# Standard Command and Window IDs
16-
The Microsoft Foundation Class Library defines a number of standard command and window IDs in Afxres.h. These IDs are most commonly used within the resource editors and the Properties window to map messages to your handler functions. All standard commands have an **ID_** prefix. For example, when you use the menu editor, you normally bind the File Open menu item to the standard `ID_FILE_OPEN` command ID.
16+
The Microsoft Foundation Class Library defines a number of standard command and window IDs in Afxres.h. These IDs are most commonly used within the resource editors and the Properties window to map messages to your handler functions. All standard commands have an **ID_** prefix. For example, when you use the menu editor, you normally bind the File Open menu item to the standard ID_FILE_OPEN command ID.
1717

18-
For most standard commands, application code does not need to refer to the command ID, because the framework itself handles the commands through message maps in its primary framework classes ( `CWinThread`, `CWinApp`, `CView`, **CDocument**, and so on).
18+
For most standard commands, application code does not need to refer to the command ID, because the framework itself handles the commands through message maps in its primary framework classes (`CWinThread`, `CWinApp`, `CView`, `CDocument`, and so on).
1919

20-
In addition to standard command IDs, a number of other standard IDs are defined which have a prefix of **AFX_ID**. These IDs include standard window IDs (prefix **AFX_IDW_**), string IDs (prefix **AFX_IDS_**), and several other types.
20+
In addition to standard command IDs, a number of other standard IDs are defined which have a prefix of **AFX_ID**. These IDs include standard window IDs (prefix **AFX_IDW_**), string IDs (prefix **AFX_IDS_**), and several other types.
2121

22-
IDs that begin with the **AFX_ID** prefix are rarely used by programmers, but you might need to refer to these IDs when overriding framework functions that also refer to the **AFX_ID**s.
22+
IDs that begin with the **AFX_ID** prefix are rarely used by programmers, but you might need to refer to these IDs when overriding framework functions that also refer to the **AFX_ID**s.
2323

24-
IDs are not individually documented in this reference. You can find more information on them in Technical Notes [20](../../mfc/tn020-id-naming-and-numbering-conventions.md), [21](../../mfc/tn021-command-and-message-routing.md), and [22](../../mfc/tn022-standard-commands-implementation.md).
24+
IDs are not individually documented in this reference. You can find more information on them in Technical Notes [20](../../mfc/tn020-id-naming-and-numbering-conventions.md), [21](../../mfc/tn021-command-and-message-routing.md), and [22](../../mfc/tn022-standard-commands-implementation.md).
2525

2626
> [!NOTE]
2727
> The header file Afxres.h is indirectly included in Afxwin.h. You must explicitly include the following statement in your application's resource script (.rc) file:

docs/mfc/reference/standard-dialog-data-exchange-routines.md

Lines changed: 45 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ This topic lists the standard dialog data exchange (DDX) routines used for commo
3939
|[DDX_Text](#ddx_text)|Initializes or retrieves the current value of an edit control.|
4040

4141
## <a name="ddx_cbindex"></a> DDX_CBIndex
42-
The `DDX_CBIndex` function manages the transfer of `int` data between a combo box control in a dialog box, form view, or control view object and a `int` data member of the dialog box, form view, or control view object.
42+
The `DDX_CBIndex` function manages the transfer of **int** data between a combo box control in a dialog box, form view, or control view object and a **int** data member of the dialog box, form view, or control view object.
4343

4444
```
4545
void AFXAPI DDX_CBIndex(
@@ -49,10 +49,10 @@ void AFXAPI DDX_CBIndex(
4949
```
5050

5151
### Parameters
52-
`pDX`
52+
*pDX*
5353
A pointer to a `CDataExchange` object. The framework supplies this object to establish the context of the data exchange, including its direction.
5454

55-
`nIDC`
55+
*nIDC*
5656
The resource ID of the combo box control associated with the control property.
5757

5858
*index*
@@ -77,10 +77,10 @@ void AFXAPI DDX_CBString(
7777
```
7878

7979
### Parameters
80-
`pDX`
80+
*pDX*
8181
A pointer to a `CDataExchange` object. The framework supplies this object to establish the context of the data exchange, including its direction.
8282

83-
`nIDC`
83+
*nIDC*
8484
The resource ID of the combo box control associated with the control property.
8585

8686
*value*
@@ -108,10 +108,10 @@ void AFXAPI DDX_CBStringExact(
108108
```
109109

110110
### Parameters
111-
`pDX`
111+
*pDX*
112112
A pointer to a `CDataExchange` object. The framework supplies this object to establish the context of the data exchange, including its direction.
113113

114-
`nIDC`
114+
*nIDC*
115115
The resource ID of the combo box control associated with the control property.
116116

117117
*value*
@@ -129,7 +129,7 @@ void AFXAPI DDX_CBStringExact(
129129
**Header** afxdd_.h
130130

131131
## <a name="ddx_check"></a> DDX_Check
132-
The `DDX_Check` function manages the transfer of `int` data between a check box control in a dialog box, form view, or control view object and a `int` data member of the dialog box, form view, or control view object.
132+
The `DDX_Check` function manages the transfer of **int** data between a check box control in a dialog box, form view, or control view object and a **int** data member of the dialog box, form view, or control view object.
133133

134134
```
135135
void AFXAPI DDX_Check(
@@ -139,10 +139,10 @@ void AFXAPI DDX_Check(
139139
```
140140

141141
### Parameters
142-
`pDX`
142+
*pDX*
143143
A pointer to a `CDataExchange` object. The framework supplies this object to establish the context of the data exchange, including its direction.
144144

145-
`nIDC`
145+
*nIDC*
146146
The resource ID of the check box control associated with the control property.
147147

148148
*value*
@@ -157,7 +157,7 @@ void AFXAPI DDX_Check(
157157
**Header** afxdd_.h
158158

159159
## <a name="ddx_control"></a> DDX_Control
160-
The `DDX_Control` function subclasses the control, specified by `nIDC`, of the dialog box, form view, or control view object.
160+
The `DDX_Control` function subclasses the control, specified by *nIDC*, of the dialog box, form view, or control view object.
161161

162162
```
163163
void AFXAPI DDX_Control(
@@ -167,17 +167,17 @@ void AFXAPI DDX_Control(
167167
```
168168

169169
### Parameters
170-
`pDX`
170+
*pDX*
171171
A pointer to a [CDataExchange](../../mfc/reference/cdataexchange-class.md) object.
172172

173-
`nIDC`
173+
*nIDC*
174174
The resource ID of the control to be subclassed.
175175

176176
*rControl*
177177
A reference to a member variable of the dialog box, form view, or control view object related to the specified control.
178178

179179
### Remarks
180-
The `pDX` object is supplied by the framework when the `DoDataExchange` function is called. Therefore, `DDX_Control` should only be called within your override of `DoDataExchange`.
180+
The *pDX* object is supplied by the framework when the `DoDataExchange` function is called. Therefore, `DDX_Control` should only be called within your override of `DoDataExchange`.
181181

182182
For more information about DDX, see [Dialog Data Exchange and Validation](../../mfc/dialog-data-exchange-and-validation.md).
183183

@@ -205,10 +205,10 @@ void AFXAPI DDX_DateTimeCtrl(
205205
```
206206

207207
### Parameters
208-
`pDX`
208+
*pDX*
209209
A pointer to a [CDataExchange](../../mfc/reference/cdataexchange-class.md) object. The framework supplies this object to establish the context of the data exchange, including its direction. You don't need to delete this object.
210210

211-
`nIDC`
211+
*nIDC*
212212
The resource ID of the date and time picker control associated with the member variable.
213213

214214
*value*
@@ -224,28 +224,25 @@ void AFXAPI DDX_DateTimeCtrl(
224224
### Requirements
225225
**Header** afxdd_.h
226226

227-
228-
229-
230227
## <a name="ddx_managedcontrol"></a> DDX_ManagedControl
231228
Creates a .NET control matching the control's resource ID.
232229

233230
### Syntax
234-
```
231+
```
235232
template <typename T>
236233
void DDX_ManagedControl(
237234
CDataExchange* pDX,
238235
int nIDC,
239236
CWinFormsControl<T>& control );
240237
```
241238
### Parameters
242-
`pDX`
239+
*pDX*
243240
A pointer to a [CDataExchange Class](cdataexchange-class.md) object. The framework supplies this object to establish the context of the data exchange, including its direction.
244241

245-
`nIDC`
242+
*nIDC*
246243
The resource ID of the control associated with the control property.
247244

248-
`control`
245+
*control*
249246
A reference to a [CWinFormsControl Class](cwinformscontrol-class.md) object.
250247

251248
### Remarks
@@ -273,14 +270,14 @@ void AFXAPI DDX_IPAddress(
273270
```
274271

275272
### Parameters
276-
`pDX`
273+
*pDX*
277274
A pointer to a `CDataExchange` object. The framework supplies this object to establish the context of the data exchange, including its direction.
278275

279-
`nIDC`
276+
*nIDC*
280277
The resource ID of the IP Address control associated with the control property.
281278

282279
*value*
283-
A reference to the `DWORD` containing the four-field value of the IP Address control. The fields are filled or read as follows.
280+
A reference to the DWORD containing the four-field value of the IP Address control. The fields are filled or read as follows.
284281

285282
|Field|Bits containing the field value|
286283
|-----------|-------------------------------------|
@@ -300,7 +297,7 @@ void AFXAPI DDX_IPAddress(
300297
**Header** afxdd_.h
301298

302299
## <a name="ddx_lbindex"></a> DDX_LBIndex
303-
The `DDX_LBIndex` function manages the transfer of `int` data between a list box control in a dialog box, form view, or control view object and an `int` data member of the dialog box, form view, or control view object.
300+
The `DDX_LBIndex` function manages the transfer of **int** data between a list box control in a dialog box, form view, or control view object and an **int** data member of the dialog box, form view, or control view object.
304301

305302
```
306303
void AFXAPI DDX_LBIndex(
@@ -310,10 +307,10 @@ void AFXAPI DDX_LBIndex(
310307
```
311308

312309
### Parameters
313-
`pDX`
310+
*pDX*
314311
A pointer to a `CDataExchange` object. The framework supplies this object to establish the context of the data exchange, including its direction.
315312

316-
`nIDC`
313+
*nIDC*
317314
The resource ID of the list box control associated with the control property.
318315

319316
*index*
@@ -338,10 +335,10 @@ void AFXAPI DDX_LBString(
338335
```
339336

340337
### Parameters
341-
`pDX`
338+
*pDX*
342339
A pointer to a `CDataExchange` object. The framework supplies this object to establish the context of the data exchange, including its direction.
343340

344-
`nIDC`
341+
*nIDC*
345342
The resource ID of the list box control associated with the control property.
346343

347344
*value*
@@ -371,10 +368,10 @@ void AFXAPI DDX_LBStringExact(
371368
```
372369

373370
### Parameters
374-
`pDX`
371+
*pDX*
375372
A pointer to a `CDataExchange` object. The framework supplies this object to establish the context of the data exchange, including its direction.
376373

377-
`nIDC`
374+
*nIDC*
378375
The resource ID of the list box control associated with the control property.
379376

380377
*value*
@@ -409,10 +406,10 @@ void AFXAPI DDX_MonthCalCtrl(
409406
```
410407

411408
### Parameters
412-
`pDX`
409+
*pDX*
413410
A pointer to a [CDataExchange](../../mfc/reference/cdataexchange-class.md) object. The framework supplies this object to establish the context of the data exchange, including its direction. You don't need to delete this object.
414411

415-
`nIDC`
412+
*nIDC*
416413
The resource ID of the month calendar control associated with the member variable.
417414

418415
*value*
@@ -431,7 +428,7 @@ void AFXAPI DDX_MonthCalCtrl(
431428
**Header** afxdd_.h
432429

433430
## <a name="ddx_radio"></a> DDX_Radio
434-
The `DDX_Radio` function manages the transfer of `int` data between a radio control group in a dialog box, form view, or control view object and a `int` data member of the dialog box, form view, or control view object. The value of the `int` data member is determined according to which radio button within the group is selected.
431+
The `DDX_Radio` function manages the transfer of **int** data between a radio control group in a dialog box, form view, or control view object and a **int** data member of the dialog box, form view, or control view object. The value of the **int** data member is determined according to which radio button within the group is selected.
435432

436433
```
437434
void AFXAPI DDX_Radio(
@@ -441,10 +438,10 @@ void AFXAPI DDX_Radio(
441438
```
442439

443440
### Parameters
444-
`pDX`
441+
*pDX*
445442
A pointer to a `CDataExchange` object. The framework supplies this object to establish the context of the data exchange, including its direction.
446443

447-
`nIDC`
444+
*nIDC*
448445
The resource ID of the first radio control in the group.
449446

450447
*value*
@@ -453,15 +450,15 @@ void AFXAPI DDX_Radio(
453450
### Remarks
454451
When `DDX_Radio` is called, *value* is set to the current state of the radio control group. The value is set as a 0-based index of the radio control that is currently checked, or -1 if no radio controls are checked.
455452

456-
For example, in case that the first radio button in the group is checked (the button with WS_GROUP style) the value of the `int` member is 0 and so on.
453+
For example, in case that the first radio button in the group is checked (the button with WS_GROUP style) the value of the **int** member is 0 and so on.
457454

458455
For more information about DDX, see [Dialog Data Exchange and Validation](../../mfc/dialog-data-exchange-and-validation.md).
459456

460457
### Requirements
461458
**Header** afxdd_.h
462459

463460
## <a name="ddx_scroll"></a> DDX_Scroll
464-
The `DDX_Scroll` function manages the transfer of `int` data between a scroll-bar control in a dialog box, form view, or control view object and an `int` data member of the dialog box, form view, or control view object.
461+
The `DDX_Scroll` function manages the transfer of **int** data between a scroll-bar control in a dialog box, form view, or control view object and an **int** data member of the dialog box, form view, or control view object.
465462

466463
```
467464
void AFXAPI DDX_Scroll(
@@ -471,10 +468,10 @@ void AFXAPI DDX_Scroll(
471468
```
472469

473470
### Parameters
474-
`pDX`
471+
*pDX*
475472
A pointer to a `CDataExchange` object. The framework supplies this object to establish the context of the data exchange, including its direction.
476473

477-
`nIDC`
474+
*nIDC*
478475
The resource ID of the scroll-bar control associated with the control property.
479476

480477
*value*
@@ -489,7 +486,7 @@ void AFXAPI DDX_Scroll(
489486
**Header** afxdd_.h
490487

491488
## <a name="ddx_slider"></a> DDX_Slider
492-
The `DDX_Slider` function manages the transfer of `int` data between a slider control in a dialog box or form view and an `int` data member of the dialog box or form view object.
489+
The `DDX_Slider` function manages the transfer of **int** data between a slider control in a dialog box or form view and an **int** data member of the dialog box or form view object.
493490

494491
```
495492
void AFXAPI DDX_Slider(
@@ -499,10 +496,10 @@ void AFXAPI DDX_Slider(
499496
```
500497

501498
### Parameters
502-
`pDX`
499+
*pDX*
503500
A pointer to a [CDataExchange](../../mfc/reference/cdataexchange-class.md) object. The framework supplies this object to establish the context of the data exchange, including its direction.
504501

505-
`nIDC`
502+
*nIDC*
506503
The resource ID of the slider control.
507504

508505
*value*
@@ -517,7 +514,7 @@ void AFXAPI DDX_Slider(
517514
**Header** afxdd_.h
518515

519516
## <a name="ddx_text"></a> DDX_Text
520-
The `DDX_Text` function manages the transfer of `int`, **UINT**, **long**, `DWORD`, `CString`, **float**, or **double** data between an edit control in a dialog box, form view, or control view and a [CString](../../atl-mfc-shared/reference/cstringt-class.md) data member of the dialog box, form view, or control view object.
517+
The `DDX_Text` function manages the transfer of **int**, **UINT**, **long**, DWORD, `CString`, **float**, or **double** data between an edit control in a dialog box, form view, or control view and a [CString](../../atl-mfc-shared/reference/cstringt-class.md) data member of the dialog box, form view, or control view object.
521518

522519
```
523520
void AFXAPI DDX_Text(
@@ -577,10 +574,10 @@ void AFXAPI DDX_Text(
577574
```
578575

579576
### Parameters
580-
`pDX`
577+
*pDX*
581578
A pointer to a [CDataExchange](../../mfc/reference/cdataexchange-class.md) object. The framework supplies this object to establish the context of the data exchange, including its direction.
582579

583-
`nIDC`
580+
*nIDC*
584581
The ID of an edit control in the dialog box, form view, or control view object.
585582

586583
*value*

0 commit comments

Comments
 (0)