Class
DataProviderBase

Represents a wrapper of ITextBasedDocumentFormatProvider allowing the latter to be used in data binding scenarios.

Definition

Namespace:Telerik.Windows.Documents.FormatProviders

Assembly:Telerik.Windows.Controls.RichTextBox.dll

Syntax:

cs-api-definition
public class DataProviderBase : FrameworkElement

Inheritance: objectDataProviderBase

Derived Classes: HtmlDataProviderRtfDataProviderTxtDataProviderXamlDataProvider

Constructors

DataProviderBase(ITextBasedDocumentFormatProvider, DependencyProperty)

Initializes a new instance of the DataProviderBase class.

Declaration

cs-api-definition
public DataProviderBase(ITextBasedDocumentFormatProvider formatProvider, DependencyProperty stringProperty)

Parameters

formatProvider

ITextBasedDocumentFormatProvider

The format provider.

stringProperty

DependencyProperty

The string property.

DataProviderBase(ITextBasedDocumentFormatProvider, FrameworkElement, DependencyProperty)

Initializes a new instance of the DataProviderBase class.

Declaration

cs-api-definition
public DataProviderBase(ITextBasedDocumentFormatProvider formatProvider, FrameworkElement propertyOwner, DependencyProperty stringProperty)

Parameters

formatProvider

ITextBasedDocumentFormatProvider

The format provider.

propertyOwner

FrameworkElement

The property owner.

stringProperty

DependencyProperty

The string property.

Fields

FormatProviderProperty

The format provider property.

Declaration

cs-api-definition
public static readonly DependencyProperty FormatProviderProperty

Field Value

DependencyProperty

RichTextBoxProperty

The rich text box property.

Declaration

cs-api-definition
public static readonly DependencyProperty RichTextBoxProperty

Field Value

DependencyProperty

UpdateSourceTriggerProperty

The update source trigger property.

Declaration

cs-api-definition
public static readonly DependencyProperty UpdateSourceTriggerProperty

Field Value

DependencyProperty

Properties

FormatProvider

Gets or sets the ITextBasedDocumentFormatProvider that is used when converting the document.

Declaration

cs-api-definition
public ITextBasedDocumentFormatProvider FormatProvider { get; set; }

Property Value

ITextBasedDocumentFormatProvider

RichTextBox

Gets or sets the RadRichTextBox this DataProvider is attached to.

Declaration

cs-api-definition
public RadRichTextBox RichTextBox { get; set; }

Property Value

RadRichTextBox

String

Gets or sets the string representing the document.

Declaration

cs-api-definition
protected string String { get; set; }

Property Value

string

The string.

UpdateSourceTrigger

Gets or sets the update source trigger.

Declaration

cs-api-definition
public DataProviderUpdateSourceTrigger UpdateSourceTrigger { get; set; }

Property Value

DataProviderUpdateSourceTrigger

The update source trigger.

Methods

Bind(RadRichTextBox)

Binds the specified RadRichTextBox.

Declaration

cs-api-definition
protected virtual void Bind(RadRichTextBox radRichTextBox)

Parameters

radRichTextBox

RadRichTextBox

The RadRichTextBox.

CreateStringProperty(string)

Creates a custom string property.

Declaration

cs-api-definition
protected static DependencyProperty CreateStringProperty(string name)

Parameters

name

string

The name.

Returns

DependencyProperty

OnAttachedDataProviderPropertyChanged(DependencyObject, DependencyPropertyChangedEventArgs)

Called after changing the attached data provider.

Declaration

cs-api-definition
public static void OnAttachedDataProviderPropertyChanged(DependencyObject dependencyObject, DependencyPropertyChangedEventArgs e)

Parameters

dependencyObject

DependencyObject

The dependency object.

e

DependencyPropertyChangedEventArgs

The DependencyPropertyChangedEventArgs instance containing the event data.

OnImportException(DataProviderImportExceptionEventArgs)

Raises the event.

Declaration

cs-api-definition
protected virtual void OnImportException(DataProviderImportExceptionEventArgs args)

Parameters

args

DataProviderImportExceptionEventArgs

The DataProviderImportExceptionEventArgs instance containing the event data.

OnSetupDocument(RadDocument)

Called when the data provider creates a new document.

Declaration

cs-api-definition
protected virtual void OnSetupDocument(RadDocument document)

Parameters

document

RadDocument

The document.

OnStringChanged()

Called when the string associated to the provider is changed.

Declaration

cs-api-definition
protected virtual void OnStringChanged()

SetValueRespectingOneWayBindings(string)

Sets the value respecting one way bindings.

Declaration

cs-api-definition
protected void SetValueRespectingOneWayBindings(string value)

Parameters

value

string

The value.

StringPropertyChangedCallback(DependencyObject, DependencyPropertyChangedEventArgs)

A callback invoked when the associated string is changed.

Declaration

cs-api-definition
protected static void StringPropertyChangedCallback(DependencyObject sender, DependencyPropertyChangedEventArgs e)

Parameters

sender

DependencyObject

The sender.

e

DependencyPropertyChangedEventArgs

The DependencyPropertyChangedEventArgs instance containing the event data.

Unbind(RadRichTextBox)

Unbinds the specified RadRichTextBox instance.

Declaration

cs-api-definition
protected virtual void Unbind(RadRichTextBox radRichTextBox)

Parameters

radRichTextBox

RadRichTextBox

The RadRichTextBox.

UpdateAttachedDataProvider(DependencyObject, Func<RadRichTextBox, DataProviderBase>, Func<DependencyObject, DataProviderBase>, Action<DependencyObject, DataProviderBase>, DependencyProperty, object)

Updates the attached data provider.

Declaration

cs-api-definition
public static void UpdateAttachedDataProvider(DependencyObject dependencyObject, Func<RadRichTextBox, DataProviderBase> formatProviderFactory, Func<DependencyObject, DataProviderBase> getAttachedDataProvider, Action<DependencyObject, DataProviderBase> setAttachedDataProvider, DependencyProperty attachedDataProviderProperty, object newValue)

Parameters

dependencyObject

DependencyObject

The dependency object.

formatProviderFactory

Func<RadRichTextBox, DataProviderBase>

The format provider factory.

getAttachedDataProvider

Func<DependencyObject, DataProviderBase>

A function that can get the attached to RadRichTextBox data provider.

setAttachedDataProvider

Action<DependencyObject, DataProviderBase>

A function that can set the attached to RadRichTextBox data provider.

attachedDataProviderProperty

DependencyProperty

The attached data provider property.

newValue

object

The new value.

UpdateDocument()

Updates the document inside the control.

Declaration

cs-api-definition
public virtual void UpdateDocument()

UpdateString()

Updates the string representing the document.

Declaration

cs-api-definition
public virtual void UpdateString()

Events

ImportException

Occurs when the import causes an exception.

Declaration

cs-api-definition
public event EventHandler<DataProviderImportExceptionEventArgs> ImportException

Event Value

EventHandler<DataProviderImportExceptionEventArgs>

SetupDocument

Occurs when the data provider creates a new document.

Declaration

cs-api-definition
public event EventHandler<SetupDocumentEventArgs> SetupDocument

Event Value

EventHandler<SetupDocumentEventArgs>

StringChanged

Occurs after the string associated to the provider changes.

Declaration

cs-api-definition
protected event EventHandler StringChanged

Event Value

EventHandler