diff --git a/docs/csharp/programming-guide/types/boxing-and-unboxing.md b/docs/csharp/programming-guide/types/boxing-and-unboxing.md index e816bf18cdf03..ec8a1672d8e4c 100644 --- a/docs/csharp/programming-guide/types/boxing-and-unboxing.md +++ b/docs/csharp/programming-guide/types/boxing-and-unboxing.md @@ -40,10 +40,9 @@ Boxing is the process of converting a [value type](../../../csharp/language-refe [!code-csharp[csProgGuideTypes#18](~/samples/snippets/csharp/VS_Snippets_VBCSharp/CsProgGuideTypes/CS/Class1.cs#18)] - The result of this statement is creating an object reference `o`, on the stack, that references a value of the type `int`, on the heap. This value is a copy of the value-type value assigned to the variable `i`. The difference between the two variables, `i` and `o`, is illustrated in the following figure. + The result of this statement is creating an object reference `o`, on the stack, that references a value of the type `int`, on the heap. This value is a copy of the value-type value assigned to the variable `i`. The difference between the two variables, `i` and `o`, is illustrated in the following image of boxing conversion: - ![BoxingConversion graphic](../../../csharp/programming-guide/types/media/vcboxingconversion.gif "vcBoxingConversion") -Boxing Conversion + ![Graphic showing the difference between i and o variables.](./media/boxing-and-unboxing/boxing-operation-i-o-variables.gif) It is also possible to perform the boxing explicitly as in the following example, but explicit boxing is never required: @@ -66,10 +65,9 @@ Boxing Conversion [!code-csharp[csProgGuideTypes#21](~/samples/snippets/csharp/VS_Snippets_VBCSharp/CsProgGuideTypes/CS/Class1.cs#21)] - The following figure demonstrates the result of the previous statements. + The following figure demonstrates the result of the previous statements: - ![UnBoxing Conversion graphic](../../../csharp/programming-guide/types/media/vcunboxingconversion.gif "vcUnBoxingConversion") -Unboxing Conversion + ![Graphic showing an unboxing conversion.](./media/boxing-and-unboxing/unboxing-conversion-operation.gif) For the unboxing of value types to succeed at run time, the item being unboxed must be a reference to an object that was previously created by boxing an instance of that value type. Attempting to unbox `null` causes a . Attempting to unbox a reference to an incompatible value type causes an . diff --git a/docs/csharp/programming-guide/types/media/vcboxingconversion.gif b/docs/csharp/programming-guide/types/media/boxing-and-unboxing/boxing-operation-i-o-variables.gif similarity index 100% rename from docs/csharp/programming-guide/types/media/vcboxingconversion.gif rename to docs/csharp/programming-guide/types/media/boxing-and-unboxing/boxing-operation-i-o-variables.gif diff --git a/docs/csharp/programming-guide/types/media/vcunboxingconversion.gif b/docs/csharp/programming-guide/types/media/boxing-and-unboxing/unboxing-conversion-operation.gif similarity index 100% rename from docs/csharp/programming-guide/types/media/vcunboxingconversion.gif rename to docs/csharp/programming-guide/types/media/boxing-and-unboxing/unboxing-conversion-operation.gif diff --git a/docs/framework/interop/callback-functions.md b/docs/framework/interop/callback-functions.md index 882af5a1cafaf..c30f318ca3f06 100644 --- a/docs/framework/interop/callback-functions.md +++ b/docs/framework/interop/callback-functions.md @@ -13,10 +13,11 @@ A callback function is code within a managed application that helps an unmanaged To call most DLL functions from managed code, you create a managed definition of the function and then call it. The process is straightforward. - Using a DLL function that requires a callback function has some additional steps. First, you must determine whether the function requires a callback by looking at the documentation for the function. Next, you have to create the callback function in your managed application. Finally, you call the DLL function, passing a pointer to the callback function as an argument. The following illustration summarizes these steps. + Using a DLL function that requires a callback function has some additional steps. First, you must determine whether the function requires a callback by looking at the documentation for the function. Next, you have to create the callback function in your managed application. Finally, you call the DLL function, passing a pointer to the callback function as an argument. + + The following illustration summarizes the callback function and implementation steps: - ![Platform invoke callback](../../../docs/framework/interop/media/pinvokecallback.gif "pinvokecallback") -Callback function and implementation + ![Diagram showing the platform invoke callback process.](./media/callback-functions/platform-invoke-callback-process.gif) Callback functions are ideal for use in situations in which a task is performed repeatedly. Another common usage is with enumeration functions, such as **EnumFontFamilies**, **EnumPrinters**, and **EnumWindows** in the Win32 API. The **EnumWindows** function enumerates through all existing windows on your computer, calling the callback function to perform a task on each window. For instructions and an example, see [How to: Implement Callback Functions](../../../docs/framework/interop/how-to-implement-callback-functions.md). diff --git a/docs/framework/interop/media/pinvokecallback.gif b/docs/framework/interop/media/callback-functions/platform-invoke-callback-process.gif similarity index 100% rename from docs/framework/interop/media/pinvokecallback.gif rename to docs/framework/interop/media/callback-functions/platform-invoke-callback-process.gif diff --git a/docs/framework/security/building-my-first-claims-aware-wcf-service.md b/docs/framework/security/building-my-first-claims-aware-wcf-service.md index 05d7093cd01ce..6d0b55e11f6b6 100644 --- a/docs/framework/security/building-my-first-claims-aware-wcf-service.md +++ b/docs/framework/security/building-my-first-claims-aware-wcf-service.md @@ -14,7 +14,7 @@ author: "BrucePerlerMS" ## Overview This topic outlines the scenario of building claims-aware WCF services using WIF. There are usually three participants in a claims-aware web service scenario: the web service itself, the end user, and the Security Token Service (STS). The following figure describes this scenario: - ![WIF Basic Claims Aware WCF Service](../../../docs/framework/security/media/wifbasicclaimsawarewcfservice.gif "WIFBasicClaimsAwareWCFService") + ![Diagram showing WIF Basic Claims Aware WCF Service components.](./media/building-my-first-claims-aware-wcf-service/windows-identify-foundation-basic-claims-aware-windows-communication-foundation-service.gif) 1. The WCF service client (sometimes called agent) uses WIF to send credentials to the STS and upon successful authentication, the agent is issued a token by the STS. diff --git a/docs/framework/security/media/wifbasicclaimsawarewcfservice.gif b/docs/framework/security/media/building-my-first-claims-aware-wcf-service/windows-identify-foundation-basic-claims-aware-windows-communication-foundation-service.gif similarity index 100% rename from docs/framework/security/media/wifbasicclaimsawarewcfservice.gif rename to docs/framework/security/media/building-my-first-claims-aware-wcf-service/windows-identify-foundation-basic-claims-aware-windows-communication-foundation-service.gif diff --git a/docs/framework/winforms/advanced/how-to-rotate-reflect-and-skew-images.md b/docs/framework/winforms/advanced/how-to-rotate-reflect-and-skew-images.md index 5b1cc633859c2..0e62dc2151ee9 100644 --- a/docs/framework/winforms/advanced/how-to-rotate-reflect-and-skew-images.md +++ b/docs/framework/winforms/advanced/how-to-rotate-reflect-and-skew-images.md @@ -24,15 +24,15 @@ You can rotate, reflect, and skew an image by specifying destination points for The following illustration shows the original image and the image mapped to the parallelogram. The original image has been skewed, reflected, rotated, and translated. The x-axis along the top edge of the original image is mapped to the line that runs through (200, 20) and (110, 100). The y-axis along the left edge of the original image is mapped to the line that runs through (200, 20) and (250, 30). - ![Stripes](./media/stripes1.gif "Stripes1") + ![The original image and the image mapped to the parallelogram.](./media/how-to-rotate-reflect-and-skew-images/reflected-skewed-rotated-illustration.gif) - The following illustration shows a similar transformation applied to a photographic image. + The following illustration shows a similar transformation applied to a photographic image: - ![Transformed Climber](./media/transformedclimber.png "TransformedClimber") + ![The picture of a climber and the picture mapped to the parallelogram.](./media/how-to-rotate-reflect-and-skew-images/reflected-skewed-rotated-photo.png) - The following illustration shows a similar transformation applied to a metafile. + The following illustration shows a similar transformation applied to a metafile: - ![Transformed Metafile](./media/transformedmetafile.png "TransformedMetafile") + ![Illustration of shapes and text and that mapped to the parallelogram.](./media/how-to-rotate-reflect-and-skew-images/reflected-skewed-rotated-metafile.png) The following example produces the images shown in the first illustration. diff --git a/docs/framework/winforms/advanced/how-to-set-pen-width-and-alignment.md b/docs/framework/winforms/advanced/how-to-set-pen-width-and-alignment.md index a877c11a22f58..9677c653e6e30 100644 --- a/docs/framework/winforms/advanced/how-to-set-pen-width-and-alignment.md +++ b/docs/framework/winforms/advanced/how-to-set-pen-width-and-alignment.md @@ -22,7 +22,7 @@ When you create a , you can supply the pen width as one - Set the value of the property to (the default) to specify that pixels drawn with the green pen will be centered on the theoretical line. The following illustration shows the resulting line. - ![Pens](./media/pens1a.gif "pens1A") + ![A black thin line with green highlight.](./media/how-to-set-pen-width-and-alignment/green-pixels-centered-line.gif) The following code example draws a rectangle twice: once with a black pen of width 1 and once with a green pen of width 10. @@ -33,9 +33,9 @@ When you create a , you can supply the pen width as one - Set the value of the property to to specify that the pixels drawn with the green pen will be centered on the boundary of the rectangle. - The following illustration shows the resulting rectangle. + The following illustration shows the resulting rectangle: - ![Pens](./media/pens2.gif "pens2") + ![A rectangle drawn with black thin lines with green highlight.](./media/how-to-set-pen-width-and-alignment/green-pixels-centered-rectangle.gif) [!code-csharp[System.Drawing.UsingAPen#42](~/samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingAPen/CS/Class1.cs#42)] [!code-vb[System.Drawing.UsingAPen#42](~/samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingAPen/VB/Class1.vb#42)] @@ -47,9 +47,9 @@ When you create a , you can supply the pen width as one [!code-csharp[System.Drawing.UsingAPen#43](~/samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingAPen/CS/Class1.cs#43)] [!code-vb[System.Drawing.UsingAPen#43](~/samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingAPen/VB/Class1.vb#43)] - Now the pixels in the wide green line appear on the inside of the rectangle as shown in the following illustration. + Now the pixels in the wide green line appear on the inside of the rectangle as shown in the following illustration: - ![Pens](./media/pens3.gif "pens3") + ![A rectangle drawn with black lines with the wide green line inside.](./media/how-to-set-pen-width-and-alignment/green-pixels-inside-rectangle.gif) ## See also - [Using a Pen to Draw Lines and Shapes](using-a-pen-to-draw-lines-and-shapes.md) diff --git a/docs/framework/winforms/advanced/media/stripes1.gif b/docs/framework/winforms/advanced/media/how-to-rotate-reflect-and-skew-images/reflected-skewed-rotated-illustration.gif similarity index 100% rename from docs/framework/winforms/advanced/media/stripes1.gif rename to docs/framework/winforms/advanced/media/how-to-rotate-reflect-and-skew-images/reflected-skewed-rotated-illustration.gif diff --git a/docs/framework/winforms/advanced/media/transformedmetafile.png b/docs/framework/winforms/advanced/media/how-to-rotate-reflect-and-skew-images/reflected-skewed-rotated-metafile.png similarity index 100% rename from docs/framework/winforms/advanced/media/transformedmetafile.png rename to docs/framework/winforms/advanced/media/how-to-rotate-reflect-and-skew-images/reflected-skewed-rotated-metafile.png diff --git a/docs/framework/winforms/advanced/media/transformedclimber.png b/docs/framework/winforms/advanced/media/how-to-rotate-reflect-and-skew-images/reflected-skewed-rotated-photo.png similarity index 100% rename from docs/framework/winforms/advanced/media/transformedclimber.png rename to docs/framework/winforms/advanced/media/how-to-rotate-reflect-and-skew-images/reflected-skewed-rotated-photo.png diff --git a/docs/framework/winforms/advanced/media/pens1a.gif b/docs/framework/winforms/advanced/media/how-to-set-pen-width-and-alignment/green-pixels-centered-line.gif similarity index 100% rename from docs/framework/winforms/advanced/media/pens1a.gif rename to docs/framework/winforms/advanced/media/how-to-set-pen-width-and-alignment/green-pixels-centered-line.gif diff --git a/docs/framework/winforms/advanced/media/pens2.gif b/docs/framework/winforms/advanced/media/how-to-set-pen-width-and-alignment/green-pixels-centered-rectangle.gif similarity index 100% rename from docs/framework/winforms/advanced/media/pens2.gif rename to docs/framework/winforms/advanced/media/how-to-set-pen-width-and-alignment/green-pixels-centered-rectangle.gif diff --git a/docs/framework/winforms/advanced/media/pens3.gif b/docs/framework/winforms/advanced/media/how-to-set-pen-width-and-alignment/green-pixels-inside-rectangle.gif similarity index 100% rename from docs/framework/winforms/advanced/media/pens3.gif rename to docs/framework/winforms/advanced/media/how-to-set-pen-width-and-alignment/green-pixels-inside-rectangle.gif diff --git a/docs/framework/wpf/controls/bulletdecorator.md b/docs/framework/wpf/controls/bulletdecorator.md index a93e895aa7807..68ecf3b9d1fc6 100644 --- a/docs/framework/wpf/controls/bulletdecorator.md +++ b/docs/framework/wpf/controls/bulletdecorator.md @@ -13,7 +13,7 @@ ms.assetid: 1756cabf-59b4-47a7-883d-1bdf2e5abe00 The following illustration shows examples of controls that use a . - ![3 BulletDecorators: CheckBox, RadioButton, TextBox](./media/bulletdecorator.png "BulletDecorator") + ![Example of a Checkbox, a RadioButton, and a TextBox bullet decorator.](./media/bulletdecorator/three-bullet-decorators.png) ## Reference diff --git a/docs/framework/wpf/controls/how-to-position-a-tooltip.md b/docs/framework/wpf/controls/how-to-position-a-tooltip.md index 906486b853b7f..b0ff04ce41ce6 100644 --- a/docs/framework/wpf/controls/how-to-position-a-tooltip.md +++ b/docs/framework/wpf/controls/how-to-position-a-tooltip.md @@ -28,16 +28,19 @@ This example shows how to specify the position of a tooltip on the screen. If you define the contents of a tooltip by using a object, you can use the properties of either class; however, the properties take precedence. Use the properties for tooltips that are not defined as objects. The following illustrations show how to position a tooltip by using these properties. Although, the [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] examples in these illustrations show how to set the properties that are defined by the class, the corresponding properties of the class follow the same layout rules. For more information about the possible values for the Placement property, see [Popup Placement Behavior](popup-placement-behavior.md). - - ![ToolTip placement](./media/tooltipplacement.png "ToolTipPlacement") -ToolTip placement by using the Placement property - - ![Placing a ToolTip by using a placement rectangle](./media/tooltipplacementrectangle.png "ToolTipPlacementRectangle") -ToolTip placement by using the Placement and PlacementRectangle properties - - ![ToolTip placement diagram](./media/tooltipplacementprhv.png "ToolTipPlacementPRHV") -ToolTip placement by using the Placement, PlacementRectangle, and Offset properties - + + The following image shows tooltip placement by using the Placement property: + + ![Diagram showing ToolTip placement by using the Placement property.](./media/how-to-position-a-tooltip/tooltip-placement-property.png) + + The following image shows tooltip placement by using the Placement and PlacementRectangle properties: + + ![Diagram showing ToolTip placement by using a PlacementRectangle property.](./media/how-to-position-a-tooltip/tooltip-placement-rectangle-property.png) + + The following image shows tooltip placement by using the Placement, PlacementRectangle, and Offset properties: + + ![Diagram showing ToolTip placement by using the Offset property.](./media/how-to-position-a-tooltip/tooltip-placement-offset-property.png) + The following example shows how to use the properties to specify the position of a tooltip whose content is a object. [!code-xaml[ToolTipService#ToolTip](~/samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml#tooltip)] diff --git a/docs/framework/wpf/controls/media/bulletdecorator.png b/docs/framework/wpf/controls/media/bulletdecorator/three-bullet-decorators.png similarity index 100% rename from docs/framework/wpf/controls/media/bulletdecorator.png rename to docs/framework/wpf/controls/media/bulletdecorator/three-bullet-decorators.png diff --git a/docs/framework/wpf/controls/media/tooltipplacementprhv.png b/docs/framework/wpf/controls/media/how-to-position-a-tooltip/tooltip-placement-offset-property.png similarity index 100% rename from docs/framework/wpf/controls/media/tooltipplacementprhv.png rename to docs/framework/wpf/controls/media/how-to-position-a-tooltip/tooltip-placement-offset-property.png diff --git a/docs/framework/wpf/controls/media/tooltipplacement.png b/docs/framework/wpf/controls/media/how-to-position-a-tooltip/tooltip-placement-property.png similarity index 100% rename from docs/framework/wpf/controls/media/tooltipplacement.png rename to docs/framework/wpf/controls/media/how-to-position-a-tooltip/tooltip-placement-property.png diff --git a/docs/framework/wpf/controls/media/tooltipplacementrectangle.png b/docs/framework/wpf/controls/media/how-to-position-a-tooltip/tooltip-placement-rectangle-property.png similarity index 100% rename from docs/framework/wpf/controls/media/tooltipplacementrectangle.png rename to docs/framework/wpf/controls/media/how-to-position-a-tooltip/tooltip-placement-rectangle-property.png