Share via


New API for the February WPF/E CTP

 

If you haven't already heard, the February CTP of WPF/E has been released (go here for more information). There are a number of sources detailing the new features added with this release, but I thought it would be worth while to list out all the new API. The API are grouped by object. The new objects and members are listed first, then the new API on existing objects are listed.

New Objects

Downloader Control   

API Notes
DownloadProgress Property Gets a value that indicates the percentage of downloaded content.
ResponseText Property Gets a string representation of the downloaded data.
Status Property Gets the current status of the Downloader object request.
StatusText Property Gets the current status of the Downloader object request.
URI Property Gets the Uniform Resource Identifier (URI) of the download request.
Abort Method Cancels the downloader request and resets properties to their initial state.
Open Method Initializes the download request.
Send Method Executes a download request.
Completed Event Occurs when the state of the download request has changed.
DownloadProgressChanged Event Occurs while content is being downloaded during a download request.

(For more information on the Downloader control, see the Using a Downloader Object topic in the SDK.)

 

KeyboardEventArgs   

API Notes
Ctrl Property Gets a value specifying whether the ctrl key was down when the event occurred.
Key Property Gets the keyboard key associated with the event.
PlatformCodeKey Property Gets a value representing the platform key associated with the event.
Shift Property Gets a value specifying whether the ctrl key was down when the event occurred.

(For more information on keyboard events, see the WPF/E Keyboard Support topic in the SDK.)

 

MouseEventArgs

API Notes
Ctrl Property Gets a value specifying whether the ctrl key was down when the event occurred.
Shift Property Gets a value specifying whether the Shift key was down when the event occurred.
X Property Gets the x-coordinates of the mouse pointer position relative to the root canvas.
Y Property Gets the y-coordinates of the mouse pointer position relative to the root canvas.

 

New Enumeration Objects

Key Specifies the portable key code that is not operating system-specific.
MediaState Defines the potential states of a MediaElement.
MouseCursor Specifies the image used to represent the mouse pointer.

 

New API on existing objects

WPF/E Control

API Notes
ActualHeight Property Specifies the height of the rendering area of the WPF/E control.
ActualWidth Property Specifies the width of the rendering area of the WPF/E control.
FullScreen Property Determines whether the WPF/E control displays as a full-screen control.
IsLoaded Property Gets a value that indicates whether the WPF/E control is loaded.
Version Property https://msdn2.microsoft.com/en-us/library/bb232865.aspx
CreateFromXamlDownloader Method Creates XAML content dynamically using downloader content.
CreateObject Method Creates a specified object and returns a reference to it.
FullScreenChanged Event Occurs whenever the FullScreen property of the WPF/E control changes.
OnLoad Event Occurs when the WPF/E control has loaded.
OnResized Event Occurs whenever the ActualHeight or ActualWidth property of the WPF/E control change.

(For more information on full screen, see the WPF/E Full Screen Support topic in the SDK.)

 

Canvas (Note, these events are only available on the root canvas.)

API Notes
KeyDown Event Occurs when the key is pressed while the content has focus.
KeyUp Event Occurs when the key is released while the control has focus.
GotFocus Event Occur when an object receives focus.
LostFocus Event Occurs when an object loses focus.

 

UIElement

API Notes
Cursor Property Gets or sets the cursor that displays when the mouse pointer is over this element.
AddEventListener Method Registers an event listener on the event target object.
RemoveEventListener Method Unregisters an event listener on the event target object.
GetHost Method Gets a reference to the containing WPF/E control.
GetParent Method Gets the parent object of the calling object.

 

MediaElement

API Notes
CurrentState Property Gets the status of the MediaElement.
AutoPlay Property Gets or sets a value indicating whether media will automatically begin playback when the Source property is set.
SetSource Method (NOTE: SetSource is also exposed on Image and ImageBrush) Sets the source value of an object with downloaded content.
CurrentStateChanged Method Occurs when the value of the CurrentState property changes.

(For more information on using audio and video in WPF/E, see the Audio and Video Overview in the SDK.)

 

TextBlock

API Notes
ActualHeight Gets the rendered height of the TextBlock.
ActualWidth Gets the rendered width of the TextBlock.

 

Collection Methods:
Add, Clear, GetItem, Insert, Remove, and RemoveAt have been added to the following collection types: PathFigureCollection, GradientStopCollection, ColorKeyFrameCollection, DoubleKeyFrameCollection, PointKeyFrameCollection, PathSegmentCollection, TriggerCollection, TriggerActionCollection.

--Brian

Comments

  • Anonymous
    February 05, 2007
    Thanks for adding the TextBlock.ActualHeight and TextBlock.ActualWidth: they were really needed. Michael S. Scherotter Mindjet Labs

  • Anonymous
    February 14, 2007
    Hi! Some questions/wishes. Do you have in mind any Data  controls? (like Datagridview, or  listview) Is there a wpf/e "full features" document? I´d love to build (in the future) a full wpf/e e-commerce site using only managed code (XAML-C#), no Ajax, no Javascript. Am I missing the picture?   Than You! Horacio

  • Anonymous
    February 14, 2007
    Hi Horacio. Thanks for your interest in WPF/E. As far as other features, such as data-aware controls are concerned, these will be considered based on customer feedback. To get an idea of the managed code programming model, take a look at the WPF/E Architecture Overview doc at: http://msdn2.microsoft.com/en-us/library/bb190633.aspx As far as AJAX is concerned, it is a complementary technology to "WPF/E" and its use is optional. Regards,
    Lorin
    WPF/E Developer Content Team