Stone_Red/docs-desktop
1
0
Fork 0
mirror of https://github.com/Stone-Red-Code/docs-desktop.git synced 2026-09-07 16:06:07 +02:00
Code Issues Packages Projects Releases Wiki Activity

Replace various WPF include files with content (#1335)

Browse Source 
* net-current-v30plus-md.md

* net-current-v40plus-md.md

* tla2sharptla-ui-md.md

* tla2sharptla-uiautomation-md.md

* tla2sharptla-winclient-md.md

* tla2sharptla-xaml-md.md

* tlasharptla-ui-md.md

* tlasharptla-uiautomation-md.md

* tlasharptla-winclient-md.md

* tlasharptla-xaml-md.md

* fix warnings
This commit is contained in:
Andy (Steve) De George
2022-03-16 12:14:11 -04:00
committed by GitHub
parent dd0052ecec
commit be103da07e
353 changed files with 1339 additions and 1349 deletions
Download Patch File Download Diff File Expand all files Collapse all files
dotnet-desktop-guide/framework/wpf/advanced/windows-forms-and-wpf-property-mapping.md
+8 -8
View File
@@ -11,7 +11,7 @@ helpviewer_keywords:
ms.assetid: 999d8298-9c04-467d-a453-86e41002057d
---
# Windows Forms and WPF Property Mapping
The Windows Forms and [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] technologies have two similar but different property models. *Property mapping* supports interoperation between the two architectures and provides the following capabilities:
The Windows Forms and WPF technologies have two similar but different property models. *Property mapping* supports interoperation between the two architectures and provides the following capabilities:
- Makes it easy to map relevant property changes in the host environment to the hosted control or element.
@@ -27,16 +27,16 @@ The Windows Forms and [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharpt
Use the <xref:System.Windows.Forms.Integration.WindowsFormsHost.PropertyMap%2A> property on the <xref:System.Windows.Forms.Integration.WindowsFormsHost> element and the <xref:System.Windows.Forms.Integration.ElementHost.PropertyMap%2A> property on <xref:System.Windows.Forms.Integration.ElementHost> control to access property mapping.
## Property Mapping with the WindowsFormsHost Element
The <xref:System.Windows.Forms.Integration.WindowsFormsHost> element translates default [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] properties to their Windows Forms equivalents using the following translation table.
The <xref:System.Windows.Forms.Integration.WindowsFormsHost> element translates default WPF properties to their Windows Forms equivalents using the following translation table.
|Windows Presentation Foundation hosting|Windows Forms|Interoperation behavior|
|---------------------------------------------|-------------------|-----------------------------|
|<xref:System.Windows.Controls.Control.Background%2A><br /><br /> (<xref:System.Windows.Media.Brush?displayProperty=nameWithType>)|<xref:System.Windows.Forms.Control.BackColor%2A><br /><br /> (<xref:System.Drawing.Color?displayProperty=nameWithType>)|The <xref:System.Windows.Forms.Integration.WindowsFormsHost> element sets the <xref:System.Windows.Forms.Control.BackColor%2A> property of the hosted control and the <xref:System.Windows.Forms.Control.BackgroundImage%2A> property of the hosted control. Mapping is performed by using the following rules:<br /><br /> - If <xref:System.Windows.Controls.Control.Background%2A> is a solid color, it is converted and used to set the <xref:System.Windows.Forms.Control.BackColor%2A> property of the hosted control. The <xref:System.Windows.Forms.Control.BackColor%2A> property is not set on the hosted control, because the hosted control can inherit the value of the <xref:System.Windows.Forms.Control.BackColor%2A> property. **Note:** The hosted control does not support transparency. Any color assigned to <xref:System.Windows.Forms.Control.BackColor%2A> must be fully opaque, with an alpha value of 0xFF. <br /><br /> - If <xref:System.Windows.Controls.Control.Background%2A> is not a solid color, the <xref:System.Windows.Forms.Integration.WindowsFormsHost> control creates a bitmap from the <xref:System.Windows.Controls.Control.Background%2A> property. The <xref:System.Windows.Forms.Integration.WindowsFormsHost> control assigns this bitmap to the <xref:System.Windows.Forms.Control.BackgroundImage%2A> property of the hosted control. This provides an effect which is similar to transparency. **Note:** You can override this behavior or you can remove the <xref:System.Windows.Controls.Control.Background%2A> property mapping.|
|<xref:System.Windows.FrameworkElement.Cursor%2A>|<xref:System.Windows.Forms.Control.Cursor%2A>|If the default mapping has not been reassigned, <xref:System.Windows.Forms.Integration.WindowsFormsHost> control traverses its ancestor hierarchy until it finds an ancestor with its <xref:System.Windows.FrameworkElement.Cursor%2A> property set. This value is translated to the closest corresponding Windows Forms cursor.<br /><br /> If the default mapping for the <xref:System.Windows.FrameworkElement.ForceCursor%2A> property has not been reassigned, the traversal stops on the first ancestor with <xref:System.Windows.FrameworkElement.ForceCursor%2A> set to `true`.|
|<xref:System.Windows.FrameworkElement.FlowDirection%2A><br /><br /> (<xref:System.Windows.FlowDirection?displayProperty=nameWithType>)|<xref:System.Windows.Forms.Control.RightToLeft%2A><br /><br /> (<xref:System.Windows.Forms.RightToLeft?displayProperty=nameWithType>)|<xref:System.Windows.FlowDirection.LeftToRight> maps to <xref:System.Windows.Forms.RightToLeft.No>.<br /><br /> <xref:System.Windows.FlowDirection.RightToLeft> maps to <xref:System.Windows.Forms.RightToLeft.Yes>.<br /><br /> <xref:System.Windows.Forms.RightToLeft.Inherit> is not mapped.<br /><br /> <xref:System.Windows.FlowDirection.RightToLeft?displayProperty=nameWithType> maps to <xref:System.Windows.Forms.RightToLeft.Yes?displayProperty=nameWithType>.|
|<xref:System.Windows.Controls.Control.FontStyle%2A>|<xref:System.Drawing.Font.Style%2A> on the hosted control's <xref:System.Drawing.Font?displayProperty=nameWithType>|The set of [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] properties is translated into a corresponding <xref:System.Drawing.Font>. When one of these properties changes, a new <xref:System.Drawing.Font> is created. For <xref:System.Windows.FontStyles.Normal%2A>: <xref:System.Drawing.FontStyle.Italic> is disabled. For <xref:System.Windows.FontStyles.Italic%2A> or <xref:System.Windows.FontStyles.Oblique%2A>: <xref:System.Drawing.FontStyle.Italic> is enabled.|
|<xref:System.Windows.Controls.Control.FontWeight%2A>|<xref:System.Drawing.Font.Style%2A> on the hosted control's <xref:System.Drawing.Font?displayProperty=nameWithType>|The set of [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] properties is translated into a corresponding <xref:System.Drawing.Font>. When one of these properties changes, a new <xref:System.Drawing.Font> is created. For <xref:System.Windows.FontWeights.Black%2A>, <xref:System.Windows.FontWeights.Bold%2A>, <xref:System.Windows.FontWeights.DemiBold%2A>, <xref:System.Windows.FontWeights.ExtraBold%2A>, <xref:System.Windows.FontWeights.Heavy%2A>, <xref:System.Windows.FontWeights.Medium%2A>, <xref:System.Windows.FontWeights.SemiBold%2A>, or <xref:System.Windows.FontWeights.UltraBold%2A>: <xref:System.Drawing.FontStyle.Bold> is enabled. For <xref:System.Windows.FontWeights.ExtraLight%2A>, <xref:System.Windows.FontWeights.Light%2A>, <xref:System.Windows.FontWeights.Normal%2A>, <xref:System.Windows.FontWeights.Regular%2A>, <xref:System.Windows.FontWeights.Thin%2A>, or <xref:System.Windows.FontWeights.UltraLight%2A>: <xref:System.Drawing.FontStyle.Bold> is disabled.|
|<xref:System.Windows.Controls.Control.FontFamily%2A><br /><br /> <xref:System.Windows.Controls.Control.FontSize%2A><br /><br /> <xref:System.Windows.Controls.Control.FontStretch%2A><br /><br /> <xref:System.Windows.Controls.Control.FontStyle%2A><br /><br /> <xref:System.Windows.Controls.Control.FontWeight%2A>|<xref:System.Windows.Forms.Control.Font%2A><br /><br /> (<xref:System.Drawing.Font?displayProperty=nameWithType>)|The set of [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] properties is translated into a corresponding <xref:System.Drawing.Font>. When one of these properties changes, a new <xref:System.Drawing.Font> is created. The hosted Windows Forms control resizes based on the font size.<br /><br /> Font size in [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] is expressed as one ninety-sixth of an inch, and in Windows Forms as one seventy-second of an inch. The corresponding conversion is:<br /><br /> Windows Forms font size = [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] font size * 72.0 / 96.0.|
|<xref:System.Windows.Controls.Control.FontStyle%2A>|<xref:System.Drawing.Font.Style%2A> on the hosted control's <xref:System.Drawing.Font?displayProperty=nameWithType>|The set of WPF properties is translated into a corresponding <xref:System.Drawing.Font>. When one of these properties changes, a new <xref:System.Drawing.Font> is created. For <xref:System.Windows.FontStyles.Normal%2A>: <xref:System.Drawing.FontStyle.Italic> is disabled. For <xref:System.Windows.FontStyles.Italic%2A> or <xref:System.Windows.FontStyles.Oblique%2A>: <xref:System.Drawing.FontStyle.Italic> is enabled.|
|<xref:System.Windows.Controls.Control.FontWeight%2A>|<xref:System.Drawing.Font.Style%2A> on the hosted control's <xref:System.Drawing.Font?displayProperty=nameWithType>|The set of WPF properties is translated into a corresponding <xref:System.Drawing.Font>. When one of these properties changes, a new <xref:System.Drawing.Font> is created. For <xref:System.Windows.FontWeights.Black%2A>, <xref:System.Windows.FontWeights.Bold%2A>, <xref:System.Windows.FontWeights.DemiBold%2A>, <xref:System.Windows.FontWeights.ExtraBold%2A>, <xref:System.Windows.FontWeights.Heavy%2A>, <xref:System.Windows.FontWeights.Medium%2A>, <xref:System.Windows.FontWeights.SemiBold%2A>, or <xref:System.Windows.FontWeights.UltraBold%2A>: <xref:System.Drawing.FontStyle.Bold> is enabled. For <xref:System.Windows.FontWeights.ExtraLight%2A>, <xref:System.Windows.FontWeights.Light%2A>, <xref:System.Windows.FontWeights.Normal%2A>, <xref:System.Windows.FontWeights.Regular%2A>, <xref:System.Windows.FontWeights.Thin%2A>, or <xref:System.Windows.FontWeights.UltraLight%2A>: <xref:System.Drawing.FontStyle.Bold> is disabled.|
|<xref:System.Windows.Controls.Control.FontFamily%2A><br /><br /> <xref:System.Windows.Controls.Control.FontSize%2A><br /><br /> <xref:System.Windows.Controls.Control.FontStretch%2A><br /><br /> <xref:System.Windows.Controls.Control.FontStyle%2A><br /><br /> <xref:System.Windows.Controls.Control.FontWeight%2A>|<xref:System.Windows.Forms.Control.Font%2A><br /><br /> (<xref:System.Drawing.Font?displayProperty=nameWithType>)|The set of WPF properties is translated into a corresponding <xref:System.Drawing.Font>. When one of these properties changes, a new <xref:System.Drawing.Font> is created. The hosted Windows Forms control resizes based on the font size.<br /><br /> Font size in WPF is expressed as one ninety-sixth of an inch, and in Windows Forms as one seventy-second of an inch. The corresponding conversion is:<br /><br /> Windows Forms font size = WPF font size * 72.0 / 96.0.|
|<xref:System.Windows.Controls.Control.Foreground%2A><br /><br /> (<xref:System.Windows.Media.Brush?displayProperty=nameWithType>)|<xref:System.Windows.Forms.Control.ForeColor%2A><br /><br /> (<xref:System.Drawing.Color?displayProperty=nameWithType>)|The <xref:System.Windows.Controls.Control.Foreground%2A> property mapping is performed by using the following rules:<br /><br /> - If <xref:System.Windows.Controls.Control.Foreground%2A> is a <xref:System.Windows.Media.SolidColorBrush>, use <xref:System.Windows.Media.SolidColorBrush.Color%2A> for <xref:System.Windows.Forms.Control.ForeColor%2A>.<br />- If <xref:System.Windows.Controls.Control.Foreground%2A> is a <xref:System.Windows.Media.GradientBrush>, use the color of the <xref:System.Windows.Media.GradientStop> with the lowest offset value for <xref:System.Windows.Forms.Control.ForeColor%2A>.<br />- For any other <xref:System.Windows.Media.Brush> type, leave <xref:System.Windows.Forms.Control.ForeColor%2A> unchanged. This means the default is used.|
|<xref:System.Windows.UIElement.IsEnabled%2A>|<xref:System.Windows.Forms.Control.Enabled%2A>|When <xref:System.Windows.UIElement.IsEnabled%2A> is set, <xref:System.Windows.Forms.Integration.WindowsFormsHost> element sets the <xref:System.Windows.Forms.Control.Enabled%2A> property on the hosted control.|
|<xref:System.Windows.Controls.Control.Padding%2A>|<xref:System.Windows.Forms.Control.Padding%2A>|All four values of the <xref:System.Windows.Forms.Control.Padding%2A> property on the hosted Windows Forms control are set to the same <xref:System.Windows.Thickness> value.<br /><br /> - Values greater than <xref:System.Int32.MaxValue> are set to <xref:System.Int32.MaxValue>.<br />- Values less than <xref:System.Int32.MinValue> are set to <xref:System.Int32.MinValue>.|
@@ -110,7 +110,7 @@ The Windows Forms and [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharpt
- Visible
The <xref:System.Windows.Forms.Integration.ElementHost> control translates default Windows Forms properties to their [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] equivalents by using the following translation table.
The <xref:System.Windows.Forms.Integration.ElementHost> control translates default Windows Forms properties to their WPF equivalents by using the following translation table.
For more information, see [Walkthrough: Mapping Properties Using the ElementHost Control](walkthrough-mapping-properties-using-the-elementhost-control.md).
@@ -119,9 +119,9 @@ The Windows Forms and [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharpt
|<xref:System.Windows.Forms.Control.BackColor%2A><br /><br /> (<xref:System.Drawing.Color?displayProperty=nameWithType>)|<xref:System.Windows.Controls.Control.Background%2A><br /><br /> (<xref:System.Windows.Media.Brush?displayProperty=nameWithType>) on the hosted element|Setting this property forces a repaint with an <xref:System.Windows.Media.ImageBrush>. If the <xref:System.Windows.Forms.Integration.ElementHost.BackColorTransparent%2A> property is set to `false` (the default value), this <xref:System.Windows.Media.ImageBrush> is based on the appearance of the <xref:System.Windows.Forms.Integration.ElementHost> control, including its <xref:System.Windows.Forms.Control.BackColor%2A>, <xref:System.Windows.Forms.Control.BackgroundImage%2A>, <xref:System.Windows.Forms.Control.BackgroundImageLayout%2A> properties, and any attached paint handlers.<br /><br /> If the <xref:System.Windows.Forms.Integration.ElementHost.BackColorTransparent%2A> property is set to `true`, the <xref:System.Windows.Media.ImageBrush> is based on the appearance of the <xref:System.Windows.Forms.Integration.ElementHost> control's parent, including the parent's <xref:System.Windows.Forms.Control.BackColor%2A>, <xref:System.Windows.Forms.Control.BackgroundImage%2A>, <xref:System.Windows.Forms.Control.BackgroundImageLayout%2A> properties, and any attached paint handlers.|
|<xref:System.Windows.Forms.Control.BackgroundImage%2A><br /><br /> (<xref:System.Drawing.Image?displayProperty=nameWithType>)|<xref:System.Windows.Controls.Control.Background%2A><br /><br /> (<xref:System.Windows.Media.Brush?displayProperty=nameWithType>) on the hosted element|Setting this property causes the same behavior described for the <xref:System.Windows.Forms.Control.BackColor%2A> mapping.|
|<xref:System.Windows.Forms.Control.BackgroundImageLayout%2A>|<xref:System.Windows.Controls.Control.Background%2A><br /><br /> (<xref:System.Windows.Media.Brush?displayProperty=nameWithType>) on the hosted element|Setting this property causes the same behavior described for the <xref:System.Windows.Forms.Control.BackColor%2A> mapping.|
|<xref:System.Windows.Forms.Control.Cursor%2A><br /><br /> (<xref:System.Windows.Forms.Cursor?displayProperty=nameWithType>)|<xref:System.Windows.FrameworkElement.Cursor%2A><br /><br /> (<xref:System.Windows.Input.Cursor?displayProperty=nameWithType>)|The Windows Forms standard cursor is translated to the corresponding [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] standard cursor. If the Windows Forms is not a standard cursor, the default is assigned.|
|<xref:System.Windows.Forms.Control.Cursor%2A><br /><br /> (<xref:System.Windows.Forms.Cursor?displayProperty=nameWithType>)|<xref:System.Windows.FrameworkElement.Cursor%2A><br /><br /> (<xref:System.Windows.Input.Cursor?displayProperty=nameWithType>)|The Windows Forms standard cursor is translated to the corresponding WPF standard cursor. If the Windows Forms is not a standard cursor, the default is assigned.|
|<xref:System.Windows.Forms.Control.Enabled%2A>|<xref:System.Windows.UIElement.IsEnabled%2A>|When <xref:System.Windows.Forms.Control.Enabled%2A> is set, the <xref:System.Windows.Forms.Integration.ElementHost> control sets the <xref:System.Windows.UIElement.IsEnabled%2A> property on the hosted element.|
|<xref:System.Windows.Forms.Control.Font%2A><br /><br /> (<xref:System.Drawing.Font?displayProperty=nameWithType>)|<xref:System.Windows.Controls.Control.FontFamily%2A><br /><br /> <xref:System.Windows.Controls.Control.FontSize%2A><br /><br /> <xref:System.Windows.Controls.Control.FontStretch%2A><br /><br /> <xref:System.Windows.Controls.Control.FontStyle%2A><br /><br /> <xref:System.Windows.Controls.Control.FontWeight%2A>|The <xref:System.Windows.Forms.Control.Font%2A> value is translated into a corresponding set of [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] font properties.|
|<xref:System.Windows.Forms.Control.Font%2A><br /><br /> (<xref:System.Drawing.Font?displayProperty=nameWithType>)|<xref:System.Windows.Controls.Control.FontFamily%2A><br /><br /> <xref:System.Windows.Controls.Control.FontSize%2A><br /><br /> <xref:System.Windows.Controls.Control.FontStretch%2A><br /><br /> <xref:System.Windows.Controls.Control.FontStyle%2A><br /><br /> <xref:System.Windows.Controls.Control.FontWeight%2A>|The <xref:System.Windows.Forms.Control.Font%2A> value is translated into a corresponding set of WPF font properties.|
|<xref:System.Drawing.Font.Bold%2A>|<xref:System.Windows.Controls.Control.FontWeight%2A> on hosted element|If <xref:System.Drawing.Font.Bold%2A> is `true`, <xref:System.Windows.Controls.Control.FontWeight%2A> is set to <xref:System.Windows.FontWeights.Bold%2A>.<br /><br /> If <xref:System.Drawing.Font.Bold%2A> is `false`, <xref:System.Windows.Controls.Control.FontWeight%2A> is set to <xref:System.Windows.FontWeights.Normal%2A>.|
|<xref:System.Drawing.Font.Italic%2A>|<xref:System.Windows.Controls.Control.FontStyle%2A> on hosted element|If <xref:System.Drawing.Font.Italic%2A> is `true`, <xref:System.Windows.Controls.Control.FontStyle%2A> is set to <xref:System.Windows.FontStyles.Italic%2A>.<br /><br /> If <xref:System.Drawing.Font.Italic%2A> is `false`, <xref:System.Windows.Controls.Control.FontStyle%2A> is set to <xref:System.Windows.FontStyles.Normal%2A>.|
|<xref:System.Drawing.Font.Strikeout%2A>|<xref:System.Windows.TextDecorations> on hosted element|Applies only when hosting a <xref:System.Windows.Controls.TextBlock> control.|