You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/atl-mfc-shared/reference/cimage-class.md
+11-11
Original file line number
Diff line number
Diff line change
@@ -343,7 +343,7 @@ BOOL BitBlt(
343
343
The logical y-coordinate of the upper left corner of the destination rectangle.
344
344
345
345
`dwROP`
346
-
The raster operation to be performed. Raster-operation codes define exactly how to combine the bits of the source, the destination, and the pattern (as defined by the currently selected brush) to form the destination. See [BitBlt](http://msdn.microsoft.com/library/windows/desktop/dd183370) in the [!INCLUDE[winSDK](./includes/winsdk_md.md)] for a list of other raster-operation codes and their descriptions.
346
+
The raster operation to be performed. Raster-operation codes define exactly how to combine the bits of the source, the destination, and the pattern (as defined by the currently selected brush) to form the destination. See [BitBlt](http://msdn.microsoft.com/library/windows/desktop/dd183370) in the Windows SDK for a list of other raster-operation codes and their descriptions.
347
347
348
348
`pointDest`
349
349
A [POINT](http://msdn.microsoft.com/library/windows/desktop/dd162805) structure indicating the upper left corner of the destination rectangle.
@@ -370,7 +370,7 @@ BOOL BitBlt(
370
370
Nonzero if successful; otherwise zero.
371
371
372
372
### Remarks
373
-
For more information, see [BitBlt](http://msdn.microsoft.com/library/windows/desktop/dd183370) in the [!INCLUDE[winSDK](./includes/winsdk_md.md)].
373
+
For more information, see [BitBlt](http://msdn.microsoft.com/library/windows/desktop/dd183370) in the Windows SDK.
374
374
375
375
## <aname="cimage"></a> CImage::CImage
376
376
Constructs a `CImage` object.
@@ -449,7 +449,7 @@ BOOL CreateEx(
449
449
-**BI_BITFIELDS** The format is uncompressed and the color table consists of three `DWORD` color masks that specify the red, green, and blue components, respectively, of each pixel. This is valid when used with 16- and 32-bpp bitmaps.
450
450
451
451
*pdwBitfields*
452
-
Only used if `eCompression` is set to **BI_BITFIELDS**, otherwise it must be **NULL**. A pointer to an array of three `DWORD` bitmasks, specifying which bits of each pixel are used for the red, green, and blue components of the color, respectively. For information on restrictions for the bitfields, see [BITMAPINFOHEADER](http://msdn.microsoft.com/library/windows/desktop/dd183376) in the [!INCLUDE[winSDK](./includes/winsdk_md.md)].
452
+
Only used if `eCompression` is set to **BI_BITFIELDS**, otherwise it must be **NULL**. A pointer to an array of three `DWORD` bitmasks, specifying which bits of each pixel are used for the red, green, and blue components of the color, respectively. For information on restrictions for the bitfields, see [BITMAPINFOHEADER](http://msdn.microsoft.com/library/windows/desktop/dd183376) in the Windows SDK.
453
453
454
454
`dwFlags`
455
455
Specifies if the bitmap object has an alpha channel. Can be a combination of zero or more of the following values:
@@ -603,7 +603,7 @@ int GetBPP() const throw();
603
603
### Remarks
604
604
This value determines the number of bits that define each pixel and the maximum number of colors in the bitmap.
605
605
606
-
The bits per pixel is usually 1, 4, 8, 16, 24, or 32. See the **biBitCount** member of [BITMAPINFOHEADER](http://msdn.microsoft.com/library/windows/desktop/dd183376) in the [!INCLUDE[winSDK](./includes/winsdk_md.md)] for more information about this value.
606
+
The bits per pixel is usually 1, 4, 8, 16, 24, or 32. See the **biBitCount** member of [BITMAPINFOHEADER](http://msdn.microsoft.com/library/windows/desktop/dd183376) in the Windows SDK for more information about this value.
An array of GUIDs, with each element corresponding to one of the file types in the string. In the example in `pszAllFilesDescription` below, `aguidFileTypes`[0] is `GUID_NULL` and the remaining array values are the image file formats supported by the current operating system.
657
657
658
658
> [!NOTE]
659
-
> For a complete list of constants, see **Image File Format Constants** in the [!INCLUDE[winSDK](./includes/winsdk_md.md)].
659
+
> For a complete list of constants, see **Image File Format Constants** in the Windows SDK.
660
660
661
661
`pszAllFilesDescription`
662
662
If this parameter is not **NULL**, the filter string will have one additional filter at the beginning of the list. This filter will have the current value of `pszAllFilesDescription` for its description, and accepts files of any extension supported by any other exporter in the list.
An array of GUIDs, with each element corresponding to one of the file types in the string. In the example in `pszAllFilesDescription` below, `aguidFileTypes`[0] is `GUID_NULL` with the remaining array values are the image file formats supported by the current operating system.
746
746
747
747
> [!NOTE]
748
-
> For a complete list of constants, see **Image File Format Constants** in the [!INCLUDE[winSDK](./includes/winsdk_md.md)].
748
+
> For a complete list of constants, see **Image File Format Constants** in the Windows SDK.
749
749
750
750
`pszAllFilesDescription`
751
751
If this parameter is not **NULL**, the filter string will have one additional filter at the beginning of the list. This filter will have the current value of `pszAllFilesDescription` for its description, and accepts files of any extension supported by any other exporter in the list.
@@ -1081,7 +1081,7 @@ BOOL MaskBlt(
1081
1081
The vertical pixel offset for the mask bitmap specified by the `hbmMask` parameter.
1082
1082
1083
1083
`dwROP`
1084
-
Specifies both foreground and background ternary raster operation codes that the method uses to control the combination of source and destination data. The background raster operation code is stored in the high-order byte of the high-order word of this value; the foreground raster operation code is stored in the low-order byte of the high-order word of this value; the low-order word of this value is ignored, and should be zero. For a discussion of foreground and background in the context of this method, see `MaskBlt` in the [!INCLUDE[winSDK](./includes/winsdk_md.md)]. For a list of common raster operation codes, see `BitBlt` in the [!INCLUDE[winSDK](./includes/winsdk_md.md)].
1084
+
Specifies both foreground and background ternary raster operation codes that the method uses to control the combination of source and destination data. The background raster operation code is stored in the high-order byte of the high-order word of this value; the foreground raster operation code is stored in the low-order byte of the high-order word of this value; the low-order word of this value is ignored, and should be zero. For a discussion of foreground and background in the context of this method, see `MaskBlt` in the Windows SDK. For a list of common raster operation codes, see `BitBlt` in the Windows SDK.
1085
1085
1086
1086
`rectDest`
1087
1087
A reference to a `RECT` structure, identifying the destination.
@@ -1172,7 +1172,7 @@ BOOL PlgBlt(
1172
1172
### Remarks
1173
1173
If `hbmMask` identifies a valid monochrome bitmap, **PlgBit** uses this bitmap to mask the bits of color data from the source rectangle.
1174
1174
1175
-
This method applies to Windows NT, versions 4.0 and later only. See [PlgBlt](http://msdn.microsoft.com/library/windows/desktop/dd162804) in the [!INCLUDE[winSDK](./includes/winsdk_md.md)] for more detailed information.
1175
+
This method applies to Windows NT, versions 4.0 and later only. See [PlgBlt](http://msdn.microsoft.com/library/windows/desktop/dd162804) in the Windows SDK for more detailed information.
> For a complete list of constants, see **Image File Format Constants** in the [!INCLUDE[winSDK](./includes/winsdk_md.md)].
1227
+
> For a complete list of constants, see **Image File Format Constants** in the Windows SDK.
1228
1228
1229
1229
### Return Value
1230
1230
A standard `HRESULT`.
@@ -1390,7 +1390,7 @@ BOOL StretchBlt(
1390
1390
The height, in logical units, of the destination rectangle.
1391
1391
1392
1392
`dwROP`
1393
-
The raster operation to be performed. Raster-operation codes define exactly how to combine the bits of the source, the destination, and the pattern (as defined by the currently selected brush) to form the destination. See [BitBlt](http://msdn.microsoft.com/library/windows/desktop/dd183370) in the [!INCLUDE[winSDK](./includes/winsdk_md.md)] for a list of other raster-operation codes and their descriptions.
1393
+
The raster operation to be performed. Raster-operation codes define exactly how to combine the bits of the source, the destination, and the pattern (as defined by the currently selected brush) to form the destination. See [BitBlt](http://msdn.microsoft.com/library/windows/desktop/dd183370) in the Windows SDK for a list of other raster-operation codes and their descriptions.
1394
1394
1395
1395
`rectDest`
1396
1396
A reference to a [RECT](http://msdn.microsoft.com/library/windows/desktop/dd162897) structure, identifying the destination.
@@ -1414,7 +1414,7 @@ BOOL StretchBlt(
1414
1414
Nonzero if successful, otherwise 0.
1415
1415
1416
1416
### Remarks
1417
-
For more information, see [StretchBlt](http://msdn.microsoft.com/library/windows/desktop/dd145120) in the [!INCLUDE[winSDK](./includes/winsdk_md.md)].
1417
+
For more information, see [StretchBlt](http://msdn.microsoft.com/library/windows/desktop/dd145120) in the Windows SDK.
A `SYSTEMTIME` structure to be converted to a date/time value and copied into the new `COleDateTime` object.
205
205
206
206
`filetimeSrc`
207
-
A `FILETIME` structure to be converted to a date/time value and copied into the new `COleDateTime` object. Note that `FILETIME` uses Universal Coordinated Time (UTC), so if you pass a local time in the structure, your results will be incorrect. See [File Times](http://msdn.microsoft.com/library/windows/desktop/ms724290) in the [!INCLUDE[winSDK](../../atl/includes/winsdk_md.md)] for more information.
207
+
A `FILETIME` structure to be converted to a date/time value and copied into the new `COleDateTime` object. Note that `FILETIME` uses Universal Coordinated Time (UTC), so if you pass a local time in the structure, your results will be incorrect. See [File Times](http://msdn.microsoft.com/library/windows/desktop/ms724290) in the Windows SDK for more information.
-`COleDateTime(`*systimeSrc***)** Constructs a `COleDateTime` object from a `SYSTEMTIME` value.
245
245
246
-
-`COleDateTime(``filetimeSrc`**)** Constructs a `COleDateTime` object from a `FILETIME` value. . Note that `FILETIME` uses Universal Coordinated Time (UTC), so if you pass a local time in the structure, your results will be incorrect. See [File Times](http://msdn.microsoft.com/library/windows/desktop/ms724290) in the [!INCLUDE[winSDK](../../atl/includes/winsdk_md.md)] for more information.
246
+
-`COleDateTime(``filetimeSrc`**)** Constructs a `COleDateTime` object from a `FILETIME` value. . Note that `FILETIME` uses Universal Coordinated Time (UTC), so if you pass a local time in the structure, your results will be incorrect. See [File Times](http://msdn.microsoft.com/library/windows/desktop/ms724290) in the Windows SDK for more information.
247
247
248
248
-`COleDateTime(``nYear`, `nMonth`, `nDay`, `nHour`, `nMin`, `nSec`**)** Constructs a `COleDateTime` object from the specified numerical values.
249
249
250
250
-`COleDateTime(``wDosDate`, `wDosTime`**)** Constructs a `COleDateTime` object from the specified MS-DOS date and time values.
251
251
252
252
For more information on the `time_t` data type, see the [time](../../c-runtime-library/reference/time-time32-time64.md) function in the *Run-Time Library Reference*.
253
253
254
-
For more information, see the [SYSTEMTIME](http://msdn.microsoft.com/library/windows/desktop/ms724950) and [FILETIME](http://msdn.microsoft.com/library/windows/desktop/ms724284) structures in the [!INCLUDE[winSDK](../../atl/includes/winsdk_md.md)].
254
+
For more information, see the [SYSTEMTIME](http://msdn.microsoft.com/library/windows/desktop/ms724950) and [FILETIME](http://msdn.microsoft.com/library/windows/desktop/ms724284) structures in the Windows SDK.
255
255
256
256
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).
-**operator =(**`udate`**)** The **UDATE** value is converted and copied into this `COleDateTime` object. If the conversion is successful, the status of this object is set to valid; if unsuccessful, it is set to invalid. A **UDATE** structure represents an "unpacked" date. See the function [VarDateFromUdate](http://msdn.microsoft.com/en-us/1c924ac5-b896-49e1-9ccf-825ac7a030c8) for more details.
765
765
766
-
-**operator =(**`filetimeSrc`**)** The [FILETIME](http://msdn.microsoft.com/library/windows/desktop/ms724284) value is converted and copied into this `COleDateTime` object. If the conversion is successful, the status of this object is set to valid; otherwise it is set to invalid. `FILETIME` uses Universal Coordinated Time (UTC), so if you pass a UTC time in the structure, your results will be converted from UTC time to local time, and will be stored as variant time. This behavior is the same as in Visual C++ 6.0 and Visual C++.NET 2003 SP2. See [File Times](http://msdn.microsoft.com/library/windows/desktop/ms724290) in the [!INCLUDE[winSDK](../../atl/includes/winsdk_md.md)] for more information.
766
+
-**operator =(**`filetimeSrc`**)** The [FILETIME](http://msdn.microsoft.com/library/windows/desktop/ms724284) value is converted and copied into this `COleDateTime` object. If the conversion is successful, the status of this object is set to valid; otherwise it is set to invalid. `FILETIME` uses Universal Coordinated Time (UTC), so if you pass a UTC time in the structure, your results will be converted from UTC time to local time, and will be stored as variant time. This behavior is the same as in Visual C++ 6.0 and Visual C++.NET 2003 SP2. See [File Times](http://msdn.microsoft.com/library/windows/desktop/ms724290) in the Windows SDK for more information.
767
767
768
-
For more information, see the [VARIANT](http://msdn.microsoft.com/en-us/e305240e-9e11-4006-98cc-26f4932d2118) entry in the [!INCLUDE[winSDK](../../atl/includes/winsdk_md.md)].
768
+
For more information, see the [VARIANT](http://msdn.microsoft.com/en-us/e305240e-9e11-4006-98cc-26f4932d2118) entry in the Windows SDK.
769
769
770
770
For more information on the `time_t` data type, see the [time](../../c-runtime-library/reference/time-time32-time64.md) function in the *Run-Time Library Reference*.
771
771
772
-
For more information, see the [SYSTEMTIME](http://msdn.microsoft.com/library/windows/desktop/ms724950) and [FILETIME](http://msdn.microsoft.com/library/windows/desktop/ms724284) structures in the [!INCLUDE[winSDK](../../atl/includes/winsdk_md.md)].
772
+
For more information, see the [SYSTEMTIME](http://msdn.microsoft.com/library/windows/desktop/ms724950) and [FILETIME](http://msdn.microsoft.com/library/windows/desktop/ms724284) structures in the Windows SDK.
773
773
774
774
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).
Copy file name to clipboardExpand all lines: docs/atl-mfc-shared/reference/cstringt-class.md
+4-4
Original file line number
Diff line number
Diff line change
@@ -235,9 +235,9 @@ BSTR AllocSysString() const;
235
235
### Remarks
236
236
In MFC programs, a [CMemoryException Class](../../mfc/reference/cmemoryexception-class.md) is thrown if insufficient memory exists. In ATL programs, a [CAtlException](../../atl/reference/catlexception-class.md) is thrown. This function is normally used to return strings for Automation.
237
237
238
-
Commonly, if this string is passed to a COM function as an [in] parameter, then this requires the caller to free the string. This can be done by using [SysFreeString](http://msdn.microsoft.com/en-us/8f230ee3-5f6e-4cb9-a910-9c90b754dcd3), as described in the [!INCLUDE[winSDK](../../atl/includes/winsdk_md.md)]. For more information, see [Allocating and Releasing Memory for a BSTR](../../atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr.md).
238
+
Commonly, if this string is passed to a COM function as an [in] parameter, then this requires the caller to free the string. This can be done by using [SysFreeString](http://msdn.microsoft.com/en-us/8f230ee3-5f6e-4cb9-a910-9c90b754dcd3), as described in the Windows SDK. For more information, see [Allocating and Releasing Memory for a BSTR](../../atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr.md).
239
239
240
-
For more information about OLE allocation functions in Windows, see [SysAllocString](http://msdn.microsoft.com/en-us/9e0437a2-9b4a-4576-88b0-5cb9d08ca29b) in the [!INCLUDE[winSDK](../../atl/includes/winsdk_md.md)].
240
+
For more information about OLE allocation functions in Windows, see [SysAllocString](http://msdn.microsoft.com/en-us/9e0437a2-9b4a-4576-88b0-5cb9d08ca29b) in the Windows SDK.
241
241
242
242
### Example
243
243
The following example demonstrates the use of `CStringT::AllocSysString`.
> `FormatMessage` attempts to allocate system memory for the newly formatted string. If this attempt fails, a memory exception is automatically thrown.
643
643
644
-
Each insert must have a corresponding parameter following the `pszFormat` or `nFormatID` parameter. Within the message text, several escape sequences are supported for dynamically formatting the message. For more information, see the Windows [FormatMessage](http://msdn.microsoft.com/library/windows/desktop/ms679351) function in the [!INCLUDE[winSDK](../../atl/includes/winsdk_md.md)].
644
+
Each insert must have a corresponding parameter following the `pszFormat` or `nFormatID` parameter. Within the message text, several escape sequences are supported for dynamically formatting the message. For more information, see the Windows [FormatMessage](http://msdn.microsoft.com/library/windows/desktop/ms679351) function in the Windows SDK.
> `FormatMessageV` calls [CStringT::FormatMessage](#formatmessage), which attempts to allocate system memory for the newly formatted string. If this attempt fails, a memory exception is automatically thrown.
668
668
669
-
For more information, see the Windows [FormatMessage](http://msdn.microsoft.com/library/windows/desktop/ms679351) function in the [!INCLUDE[winSDK](../../atl/includes/winsdk_md.md)].
669
+
For more information, see the Windows [FormatMessage](http://msdn.microsoft.com/library/windows/desktop/ms679351) function in the Windows SDK.
670
670
671
671
## <aname="formatv"></a> CStringT::FormatV
672
672
Formats a message string using a variable argument list.
0 commit comments