IXRWin32Control (Windows Embedded CE 6.0)
1/6/2010
This class represents a Win32 control in a Silverlight for Windows Embedded application.
Syntax
class IXRWin32Control : public IXRControl
Methods
| Method | Description |
|---|---|
Retrieves the name of the class that this IXRWin32Control object belongs to. |
|
Retrieves the handle to this IXRWin32Control object. |
|
Sets the name of the class that this IXRWin32Control object belongs to. |
|
Sets an existing window handle as the new handle for this IXRWin32Control object, so that the IXRWin32Control object represents a child window control of the visual host window. |
Remarks
You can use a Win32 control to create a control that has a WndProc. The WndProc for the control has message-handling behavior that is separate from the message-handling behavior for the WndProc for the main window.
You can use this class to create an IXRWin32Control control, add it to the visual tree that is attached to the visual root of your application, and then set its handle to your own window control. For more information, see Add a Window Control to a Silverlight for Windows Embedded Application.
When the Win32 control receives UI focus, its WndProc processes all the input messages. When the user presses the TAB key, if you did not add custom event handling code for the TAB event in the WndProc for the Win32 control, Silverlight handles the TAB event by giving focus to the next object in the visual-host window.
Note
Do not implement custom event-handling code for the TAB event in the WndProc for the Win32 control. Silverlight handles the TAB event for the Win32 control by giving the UI focus back to the main window.
To create an IXRWin32Control object in Silverlight and associate it with the handle to a window control, you can use several methods in IXRControl and in other inherited classes. By using these methods, the window control can leverage qualities such as animation storyboards, position, and layout. You can set properties associated with the following inherited methods by calling these methods or by defining the associated XAML attributes in the source Microsoft Silverlight 2 XAML file.
Note
Calling any other methods in parent classes that set values results in an error.
| Method | Description |
|---|---|
Sets the height of the Win32 control. |
|
Sets the horizontal-alignment characteristics that determine the position of the Win32 control when Silverlight displays it within a parent element, such as a panel control or an items control. |
|
Sets a value that indicates whether Silverlight includes the Win32 control in the tab order for UI focus. |
|
Sets the width of the frame that surrounds the Win32 control. |
|
Sets the maximum height constraint of the Win32 control. |
|
Sets the maximum width constraint of the Win32 control. |
|
Sets the minimum height constraint of the Win32 control. |
|
Sets the minimum width constraint of the Win32 control. |
|
Sets the identifying name of the Win32 control. |
|
Sets the transformation to apply when Silverlight renders the Win32 control. |
|
Sets the new vertical-alignment characteristics that determine the position of the Win32 control when Silverlight displays it within a parent element, such as a panel control or an items control. |
|
Sets the new width of the Win32 control. |
Note
The IXRFrameworkElement::FindName method searches for the name associated with the x:Name attribute for this Win32 control when it is in the object tree, not for the class name.
Example
The following example code creates an IXRWin32Control, sets its handle as the handle to a window control, and adds it to a panel object that is in the visual tree for the application.
#include "XamlRuntime.h"
CreateControl(IXRApplication* pApplication, IXRPanel* pPanel, HWND HandleToWindowControl)
{
IXRWin32Control *pIWin32Ctl = NULL;
pApplication->CreateObject(IID_IXRWin32Control, &pIWin32Ctl);
pIWin32Ctl->SetClassName(L"MyControlClass");
pIWin32Ctl->SetName(L"Win32CtlSample");
pIWin32Ctl->SetHeight(80);
pIWin32Ctl->SetWidth(200);
pIWin32Ctl->SetHorizontalAlignment(XRHorizontalAlignment_Left);
pIWin32Ctl->SetVerticalAlignment(XRVerticalAlignment_Top);
pIWin32Ctl->SetHandle(&HandleToWindowControl, false);
IXRUIElementCollection *pChildCollection;
pPanel->GetChildren(&pChildCollection);
pChildCollection->Add(&pIWin32Control, NULL);
}
For more information about the classes used in this example, see IXRApplication, IXRPanel and IXRUIElementCollection.
Inheritance Hierarchy
IXRWin32Control
.NET Framework Equivalent
None.
Requirements
| Header | XamlRuntime.h |
| sysgen | SYSGEN_XAML_RUNTIME |
| Windows Embedded CE | Windows Embedded CE 6.0 R3 |
See Also
Tasks
Add a Window Control to a Silverlight for Windows Embedded Application
Reference
Classes for UI Element Management