Skip to content

Repo sync for protected CLA branch #3900

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
May 16, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions docs/atl-mfc-shared/reference/cimage-class.md
Original file line number Diff line number Diff line change
Expand Up @@ -691,7 +691,7 @@ Set of bit flags specifying which file types to exclude from the list. Allowable

- `excludeDefaultLoad` = 0 For load, all file types are included by default

- `excludeDefaultSave` = `excludeIcon | excludeEMF | excludeWMF` For saving, these files are excluded by default because they usually have special requirements.
- `excludeDefaultSave` = `excludeIcon | excludeEMF | excludeWMF` For saving, these files are excluded by default because they usually have special requirements.

*`chSeparator`*<br/>
The separator used between the image formats. See **Remarks** for more information.
Expand All @@ -706,13 +706,13 @@ You can pass the resulting format string to your MFC [`CFileDialog`](../../mfc/r

The parameter *`strExporter`* has the format:

file description0&#124;\*.ext0&#124;filedescription1&#124;\*.ext1&#124;...file description *n*&#124;\*.ext *n*&#124;&#124;
`file description 0|*.ext0|file description 1|*.ext1|...file description N|*.extN||`

where '&#124;' is the separator character specified by `chSeparator`. For example:
where `|` is the separator character specified by `chSeparator`. For example:

`"Bitmap format|*.bmp|JPEG format|*.jpg|GIF format|*.gif|PNG format|*.png||"`

Use the default separator '&#124;' if you pass this string to an MFC `CFileDialog` object. Use the null separator '\0' if you pass this string to a common File Save dialog box.
Use the default separator `|` if you pass this string to an MFC `CFileDialog` object. Use the null separator `'\0'` if you pass this string to a common File Save dialog box.

## <a name="getheight"></a> `CImage::GetHeight`

Expand Down Expand Up @@ -786,7 +786,7 @@ Set of bit flags specifying which file types to exclude from the list. Allowable

- `excludeDefaultLoad` = 0 For load, all file types are included by default

- `excludeDefaultSave` = `excludeIcon &#124; excludeEMF &#124; excludeWMF` For saving, these files are excluded by default because they usually have special requirements.
- `excludeDefaultSave` = `excludeIcon | excludeEMF | excludeWMF` For saving, these files are excluded by default because they usually have special requirements.

*`chSeparator`*<br/>
The separator used between the image formats. See **Remarks** for more information.
Expand All @@ -797,13 +797,13 @@ You can pass the resulting format string to your MFC [`CFileDialog`](../../mfc/r

The parameter *`strImporter`* has the format:

file description0&#124;\*.ext0&#124;filedescription1&#124;\*.ext1&#124;...file description *n*&#124;\*.ext *n*&#124;&#124;
`file description 0|*.ext0|file description 1|*.ext1|...file description N|*.extN||

where '&#124;' is the separator character specified by *`chSeparator`*. For example:
where `|` is the separator character specified by *`chSeparator`*. For example:

`"Bitmap format|*.bmp|JPEG format|*.jpg|GIF format|*.gif|PNG format|*.png||"`

Use the default separator '&#124;' if you pass this string to an MFC `CFileDialog` object. Use the null separator '\0' if you pass this string to a common **File Open** dialog box.
Use the default separator `|` if you pass this string to an MFC `CFileDialog` object. Use the null separator `'\0'` if you pass this string to a common **File Open** dialog box.

## <a name="getmaxcolortableentries"></a> `CImage::GetMaxColorTableEntries`

Expand Down
2 changes: 1 addition & 1 deletion docs/atl/adding-a-control-atl-tutorial-part-2.md
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ Now you can build the control to see it in action.

Next, you'll add a custom property to the control.

[Back to Step 1](../atl/creating-the-project-atl-tutorial-part-1.md) &#124; [On to Step 3](../atl/adding-a-property-to-the-control-atl-tutorial-part-3.md)
[Back to Step 1](../atl/creating-the-project-atl-tutorial-part-1.md) \| [On to Step 3](../atl/adding-a-property-to-the-control-atl-tutorial-part-3.md)

## See also

Expand Down
2 changes: 1 addition & 1 deletion docs/atl/adding-a-property-page-atl-tutorial-part-6.md
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,7 @@ The **Apply** button is initially disabled. Start typing a value in the **Sides*

Next, you will put your control on a Web page.

[Back to Step 5](../atl/adding-an-event-atl-tutorial-part-5.md) &#124; [On to Step 7](../atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md)
[Back to Step 5](../atl/adding-an-event-atl-tutorial-part-5.md) \| [On to Step 7](../atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md)

## See also

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ The `get_Sides` method returns the current value of the `Sides` property through

You now have a property called `Sides`. In the next step, you will change the drawing code to use it.

[Back to Step 2](../atl/adding-a-control-atl-tutorial-part-2.md) &#124; [On to Step 4](../atl/changing-the-drawing-code-atl-tutorial-part-4.md)
[Back to Step 2](../atl/adding-a-control-atl-tutorial-part-2.md) \| [On to Step 4](../atl/changing-the-drawing-code-atl-tutorial-part-4.md)

## See also

Expand Down
2 changes: 1 addition & 1 deletion docs/atl/adding-an-event-atl-tutorial-part-5.md
Original file line number Diff line number Diff line change
Expand Up @@ -149,7 +149,7 @@ Now try out your events. Build the control and start the ActiveX Control Test Co

Next, you will add a property page.

[Back to Step 4](../atl/changing-the-drawing-code-atl-tutorial-part-4.md) &#124; [On to Step 6](../atl/adding-a-property-page-atl-tutorial-part-6.md)
[Back to Step 4](../atl/changing-the-drawing-code-atl-tutorial-part-4.md) \| [On to Step 6](../atl/adding-a-property-page-atl-tutorial-part-6.md)

## See also

Expand Down
2 changes: 1 addition & 1 deletion docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md
Original file line number Diff line number Diff line change
Expand Up @@ -151,7 +151,7 @@ After adding `FireViewChange`, rebuild and try the control again in the ActiveX

In the next step, you will add an event.

[Back to Step 3](../atl/adding-a-property-to-the-control-atl-tutorial-part-3.md) &#124; [On to Step 5](../atl/adding-an-event-atl-tutorial-part-5.md)
[Back to Step 3](../atl/adding-a-property-to-the-control-atl-tutorial-part-3.md) \| [On to Step 5](../atl/adding-an-event-atl-tutorial-part-5.md)

## See also

Expand Down
2 changes: 1 addition & 1 deletion docs/atl/reference/catltransactionmanager-class.md
Original file line number Diff line number Diff line change
Expand Up @@ -165,7 +165,7 @@ inline HANDLE CreateFile(
The name of an object to be created or opened.

*dwDesiredAccess*<br/>
The access to the object, which can be summarized as read, write, both, or neither (zero). The most commonly used values are GENERIC_READ, GENERIC_WRITE, or both: GENERIC_READ &#124; GENERIC_WRITE.
The access to the object, which can be summarized as read, write, both, or neither (zero). The most commonly used values are `GENERIC_READ`, `GENERIC_WRITE`, or both: `GENERIC_READ | GENERIC_WRITE`.

*dwShareMode*<br/>
The sharing mode of an object, which can be read, write, both, delete, all of these, or none: 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.
Expand Down
2 changes: 1 addition & 1 deletion docs/atl/reference/ccontainedwindowt-class.md
Original file line number Diff line number Diff line change
Expand Up @@ -197,7 +197,7 @@ HWND Create(
[in] Specifies the name of the window. The default value is NULL.

*dwStyle*<br/>
[in] The style of the window. The default value is WS_CHILD &#124; WS_VISIBLE. For a list of possible values, see [CreateWindow](/windows/win32/api/winuser/nf-winuser-createwindoww) in the Windows SDK.
[in] The style of the window. The default value is `WS_CHILD | WS_VISIBLE`. For a list of possible values, see [CreateWindow](/windows/win32/api/winuser/nf-winuser-createwindoww) in the Windows SDK.

*dwExStyle*<br/>
[in] The extended window style. The default value is 0, meaning no extended style. For a list of possible values, see [CreateWindowEx](/windows/win32/api/winuser/nf-winuser-createwindowexw) in the Windows SDK.
Expand Down
46 changes: 23 additions & 23 deletions docs/c-runtime-library/byte-classification.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,36 +8,36 @@ ms.assetid: 1cb52d71-fb0c-46ca-aad7-6472c1103370
---
# Byte classification

Each of these routines tests a specified byte of a multibyte character for satisfaction of a condition. Except where specified otherwise, the output value is affected by the setting of the **LC_CTYPE** category setting of the locale; see [setlocale](../c-runtime-library/reference/setlocale-wsetlocale.md) for more information. The versions of these functions without the **_l** suffix use the current locale for this locale-dependent behavior; the versions with the **_l** suffix are identical except that they use the locale parameter passed in instead.
Each of these routines tests a specified byte of a multibyte character for satisfaction of a condition. Except where specified otherwise, the output value is affected by the setting of the `LC_CTYPE` category setting of the locale. For more information, see [`setlocale`](../c-runtime-library/reference/setlocale-wsetlocale.md). The versions of these functions without the **`_l`** suffix use the current locale for this locale-dependent behavior; the versions with the **`_l`** suffix are identical except that they use the locale parameter passed in instead.

> [!NOTE]
> By definition, the ASCII characters between 0 and 127 are a subset of all multibyte-character sets. For example, the Japanese katakana character set includes ASCII as well as non-ASCII characters.

The predefined constants in the following table are defined in \<ctype.h>.
The predefined constants in the following table are defined in `<ctype.h>`.

## Multibyte-character byte-classification routines

|Routine|Byte Test Condition|
|-------------|-------------------------|
|[isleadbyte, _isleadbyte_l](../c-runtime-library/reference/isleadbyte-isleadbyte-l.md)|Lead byte; test result depends on **LC_CTYPE** category setting of current locale|
|[_ismbbalnum, _ismbbalnum_l](../c-runtime-library/reference/ismbbalnum-ismbbalnum-l.md)|**isalnum** &#124;&#124; **_ismbbkalnum**|
|[_ismbbalpha, _ismbbalpha_l](../c-runtime-library/reference/ismbbalpha-ismbbalpha-l.md)|**isalpha** &#124;&#124; **_ismbbkalnum**|
|[_ismbbgraph, _ismbbgraph_l](../c-runtime-library/reference/ismbbgraph-ismbbgraph-l.md)|Same as **_ismbbprint**, but **_ismbbgraph** does not include the space character (0x20)|
|[_ismbbkalnum, _ismbbkalnum_l](../c-runtime-library/reference/ismbbkalnum-ismbbkalnum-l.md)|Non-ASCII text symbol other than punctuation. For example, in code page 932 only, **_ismbbkalnum** tests for katakana alphanumeric|
|[_ismbbkana, _ismbbkana_l](../c-runtime-library/reference/ismbbkana-ismbbkana-l.md)|Katakana (0xA1 - 0xDF), code page 932 only|
|[_ismbbkprint, _ismbbkprint_l](../c-runtime-library/reference/ismbbkprint-ismbbkprint-l.md)|Non-ASCII text or non-ASCII punctuation symbol. For example, in code page 932 only, **_ismbbkprint** tests for katakana alphanumeric or katakana punctuation (range: 0xA1 - 0xDF).|
|[_ismbbkpunct, _ismbbkpunct_l](../c-runtime-library/reference/ismbbkpunct-ismbbkpunct-l.md)|Non-ASCII punctuation. For example, in code page 932 only, **_ismbbkpunct** tests for katakana punctuation.|
|[_ismbblead, _ismbblead_l](../c-runtime-library/reference/ismbblead-ismbblead-l.md)|First byte of multibyte character. For example, in code page 932 only, valid ranges are 0x81 - 0x9F, 0xE0 - 0xFC.|
|[_ismbbprint, _ismbbprint_l](../c-runtime-library/reference/ismbbprint-ismbbprint-l.md)|**isprint** &#124;&#124; **_ismbbkprint**. **ismbbprint** includes the space character (0x20)|
|[_ismbbpunct, _ismbbpunct_l](../c-runtime-library/reference/ismbbpunct-ismbbpunct-l.md)|**ispunct** &#124;&#124; **_ismbbkpunct**|
|[_ismbbtrail, _ismbbtrail_l](../c-runtime-library/reference/ismbbtrail-ismbbtrail-l.md)|Second byte of multibyte character. For example, in code page 932 only, valid ranges are 0x40 - 0x7E, 0x80 - 0xEC.|
|[_ismbslead, _ismbslead_l](../c-runtime-library/reference/ismbslead-ismbstrail-ismbslead-l-ismbstrail-l.md)|Lead byte (in string context)|
|[ismbstrail, _ismbstrail_l](../c-runtime-library/reference/ismbslead-ismbstrail-ismbslead-l-ismbstrail-l.md)|Trail byte (in string context)|
|[_mbbtype, _mbbtype_l](../c-runtime-library/reference/mbbtype-mbbtype-l.md)|Return byte type based on previous byte|
|[_mbsbtype, _mbsbtype_l](../c-runtime-library/reference/mbsbtype-mbsbtype-l.md)|Return type of byte within string|
|[mbsinit](../c-runtime-library/reference/mbsinit.md)|Tracks the state of a multibyte character conversion.|

The **MB_LEN_MAX** macro, defined in \<limits.h>, expands to the maximum length in bytes that any multibyte character can have. **MB_CUR_MAX**, defined in \<stdlib.h>, expands to the maximum length in bytes of any multibyte character in the current locale.
| Routine | Byte Test Condition |
|--|--|
| [`isleadbyte`, `_isleadbyte_l`](../c-runtime-library/reference/isleadbyte-isleadbyte-l.md) | Lead byte; test result depends on `LC_CTYPE` category setting of current locale |
| [`_ismbbalnum`, `_ismbbalnum_l`](../c-runtime-library/reference/ismbbalnum-ismbbalnum-l.md) | `isalnum || _ismbbkalnum` |
| [`_ismbbalpha`, `_ismbbalpha_l`](../c-runtime-library/reference/ismbbalpha-ismbbalpha-l.md) | `isalpha || _ismbbkalpha` |
| [`_ismbbgraph`, `_ismbbgraph_l`](../c-runtime-library/reference/ismbbgraph-ismbbgraph-l.md) | Same as `_ismbbprint`, but `_ismbbgraph` does not include the space character (0x20) |
| [`_ismbbkalnum`, `_ismbbkalnum_l`](../c-runtime-library/reference/ismbbkalnum-ismbbkalnum-l.md) | Non-ASCII text symbol other than punctuation. For example, in code page 932 only, `_ismbbkalnum` tests for katakana alphanumeric |
| [`_ismbbkana`, `_ismbbkana_l`](../c-runtime-library/reference/ismbbkana-ismbbkana-l.md) | Katakana (0xA1 - 0xDF), code page 932 only |
| [`_ismbbkprint`, `_ismbbkprint_l`](../c-runtime-library/reference/ismbbkprint-ismbbkprint-l.md) | Non-ASCII text or non-ASCII punctuation symbol. For example, in code page 932 only, `_ismbbkprint` tests for katakana alphanumeric or katakana punctuation (range: 0xA1 - 0xDF). |
| [`_ismbbkpunct`, `_ismbbkpunct_l`](../c-runtime-library/reference/ismbbkpunct-ismbbkpunct-l.md) | Non-ASCII punctuation. For example, in code page 932 only, `_ismbbkpunct` tests for katakana punctuation. |
| [`_ismbblead`, `_ismbblead_l`](../c-runtime-library/reference/ismbblead-ismbblead-l.md) | First byte of multibyte character. For example, in code page 932 only, valid ranges are 0x81 - 0x9F, 0xE0 - 0xFC. |
| [`_ismbbprint`, `_ismbbprint_l`](../c-runtime-library/reference/ismbbprint-ismbbprint-l.md) | `isprint || _ismbbkprint`. `ismbbprint` includes the space character (0x20) |
| [`_ismbbpunct`, `_ismbbpunct_l`](../c-runtime-library/reference/ismbbpunct-ismbbpunct-l.md) | `ispunct || _ismbbkpunct` |
| [`_ismbbtrail`, `_ismbbtrail_l`](../c-runtime-library/reference/ismbbtrail-ismbbtrail-l.md) | Second byte of multibyte character. For example, in code page 932 only, valid ranges are 0x40 - 0x7E, 0x80 - 0xEC. |
| [`_ismbslead`, `_ismbslead_l`](../c-runtime-library/reference/ismbslead-ismbstrail-ismbslead-l-ismbstrail-l.md) | Lead byte (in string context) |
| [`ismbstrail`, `_ismbstrail_l`](../c-runtime-library/reference/ismbslead-ismbstrail-ismbslead-l-ismbstrail-l.md) | Trail byte (in string context) |
| [`_mbbtype`, `_mbbtype_l`](../c-runtime-library/reference/mbbtype-mbbtype-l.md) | Return byte type based on previous byte |
| [`_mbsbtype`, `_mbsbtype_l`](../c-runtime-library/reference/mbsbtype-mbsbtype-l.md) | Return type of byte within string |
| [`mbsinit`](../c-runtime-library/reference/mbsinit.md) | Tracks the state of a multibyte character conversion. |

The `MB_LEN_MAX` macro, defined in `<limits.h>`, expands to the maximum length in bytes that any multibyte character can have. `MB_CUR_MAX`, defined in `<stdlib.h>`, expands to the maximum length in bytes of any multibyte character in the current locale.

## See also

Expand Down
2 changes: 1 addition & 1 deletion docs/c-runtime-library/file-attribute-constants.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ The attributes are represented by the following manifest constants:
|`_A_SUBDIR`| Subdirectory. Value: 0x10|
|`_A_SYSTEM`| System file. Not normally seen with the DIR command, unless the /AS option is used. Value: 0x04|

Multiple constants can be combined with the OR operator (&#124;).
Multiple constants can be combined with the OR operator (`|`).

## See also

Expand Down
4 changes: 2 additions & 2 deletions docs/c-runtime-library/file-permission-constants.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,15 +23,15 @@ The `pmode` argument specifies the file's permission settings as follows.
|--------------|-------------|
|`_S_IREAD`|Reading permitted|
|`_S_IWRITE`|Writing permitted|
|`_S_IREAD` &#124; `_S_IWRITE`|Reading and writing permitted|
|`_S_IREAD | _S_IWRITE`|Reading and writing permitted|

When used as the `pmode` argument for `_umask`, the manifest constant sets the permission setting, as follows.

|Constant|Meaning|
|--------------|-------------|
|`_S_IREAD`|Writing not permitted (file is read-only)|
|`_S_IWRITE`|Reading not permitted (file is write-only)|
|`_S_IREAD` &#124; `_S_IWRITE`|Neither reading nor writing permitted|
|`_S_IREAD | _S_IWRITE`|Neither reading nor writing permitted|

## See also

Expand Down
Loading