Back to Devexpress

DocumentCapabilitiesOptions.Hyperlinks Property

officefileapi-devexpress-dot-xtrarichedit-dot-documentcapabilitiesoptions-bc5b819f.md

latest9.3 KB
Original Source

DocumentCapabilitiesOptions.Hyperlinks Property

Gets or sets the hyperlink feature availability.

Namespace : DevExpress.XtraRichEdit

Assembly : DevExpress.RichEdit.v25.2.Core.dll

NuGet Package : DevExpress.RichEdit.Core

Declaration

csharp
[DefaultValue(DocumentCapability.Default)]
public virtual DocumentCapability Hyperlinks { get; set; }
vb
<DefaultValue(DocumentCapability.Default)>
Public Overridable Property Hyperlinks As DocumentCapability

Property Value

TypeDefaultDescription
DocumentCapabilityDefault

A DocumentCapability enumeration specifying the document’s capability to handle hyperlinks.

|

Available values:

NameDescription
Default

The value is determined by the current setting. The default value is automatically set if it is not explicitly specified.

| | Disabled |

The feature is not allowed and the corresponding commands are shown disabled.

| | Enabled |

The feature is available and the corresponding commands are shown enabled.

| | Hidden |

The feature is not available and the corresponding commands are hidden.

|

Property Paths

You can access this nested property as listed below:

Object TypePath to Hyperlinks
RichEditControlOptionsBase

.DocumentCapabilities .Hyperlinks

|

Remarks

This property affects the ability to create, modify, delete and follow hyperlinks in the document using the built-in features.

The DocumentCapability.Default value for the Hyperlinks property is equal to DocumentCapability.Enabled, so that the hyperlinks are available for a currently loaded document.

With the Hyperlinks property set to DocumentCapability.Disabled, existing hyperlinks become inactive for end-users.

Note

The hyperlink is a specific kind of a document field, therefore the DocumentCapabilitiesOptions.Fields property affects the hyperlink loading process when importing the document. Set the RichEditControlCompatibility.LoadHyperlinkAsField property to false before the InitializeComponent method call to correct this behavior and allow the control to load hyperlinks when field loading is disabled.

The following code snippets (auto-collected from DevExpress Examples) contain references to the Hyperlinks property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

wpf-spreadsheet-chart-api/CS/SpreadsheetWPFChartAPISamples/CodeUtils/SpreadsheetApiModuleUtils.cs#L126

csharp
RichEditControlOptionsBase options = codeEditor.InnerDocumentServer.Options;
options.DocumentCapabilities.Hyperlinks = DocumentCapability.Disabled;
options.DocumentCapabilities.Numbering.Bulleted = DocumentCapability.Disabled;

wpf-spreadsheet-pivot-table-api-examples/CS/SpreadsheetWPFPivotTableExamples/CodeUtils/SpreadsheetApiModuleUtils.cs#L150

csharp
RichEditControlOptionsBase options = codeEditor.InnerDocumentServer.Options;
options.DocumentCapabilities.Hyperlinks = DocumentCapability.Disabled;
options.DocumentCapabilities.Numbering.Bulleted = DocumentCapability.Disabled;

winforms-spreadsheet-chart-api/CS/SpreadsheetChartAPISamples/CodeUtils/SpreadsheetApiModuleUtils.cs#L126

csharp
RichEditControlOptionsBase options = codeEditor.InnerDocumentServer.Options;
options.DocumentCapabilities.Hyperlinks = DocumentCapability.Disabled;
options.DocumentCapabilities.Numbering.Bulleted = DocumentCapability.Disabled;

winforms-spreadsheet-pivot-table-api/CS/SpreadsheetPivotTableExamples/CodeUtils/SpreadsheetApiModuleUtils.cs#L150

csharp
RichEditControlOptionsBase options = codeEditor.InnerDocumentServer.Options;
options.DocumentCapabilities.Hyperlinks = DocumentCapability.Disabled;
options.DocumentCapabilities.Numbering.Bulleted = DocumentCapability.Disabled;

winforms-spreadsheetcontrol-api-part-3/CS/SpreadsheetControl_API_Part03/CodeUtils/ExampleCodeEditor.cs#L197

csharp
RichEditControlOptionsBase options = codeEditor.InnerDocumentServer.Options;
options.DocumentCapabilities.Hyperlinks = DocumentCapability.Disabled;
options.DocumentCapabilities.Numbering.Bulleted = DocumentCapability.Disabled;

wpf-spreadsheet-chart-api/VB/SpreadsheetWPFChartAPISamples/CodeUtils/SpreadsheetApiModuleUtils.vb#L137

vb
Dim options As RichEditControlOptionsBase = codeEditor.InnerDocumentServer.Options
options.DocumentCapabilities.Hyperlinks = DocumentCapability.Disabled
options.DocumentCapabilities.Numbering.Bulleted = DocumentCapability.Disabled

wpf-spreadsheet-pivot-table-api-examples/VB/SpreadsheetWPFPivotTableExamples/CodeUtils/SpreadsheetApiModuleUtils.vb#L136

vb
Dim options As RichEditControlOptionsBase = codeEditor.InnerDocumentServer.Options
options.DocumentCapabilities.Hyperlinks = DocumentCapability.Disabled
options.DocumentCapabilities.Numbering.Bulleted = DocumentCapability.Disabled

winforms-spreadsheet-chart-api/VB/SpreadsheetChartAPISamples/CodeUtils/SpreadsheetApiModuleUtils.vb#L136

vb
Dim options As RichEditControlOptionsBase = codeEditor.InnerDocumentServer.Options
options.DocumentCapabilities.Hyperlinks = DocumentCapability.Disabled
options.DocumentCapabilities.Numbering.Bulleted = DocumentCapability.Disabled

winforms-spreadsheet-pivot-table-api/VB/SpreadsheetPivotTableExamples/CodeUtils/SpreadsheetApiModuleUtils.vb#L136

vb
Dim options As RichEditControlOptionsBase = codeEditor.InnerDocumentServer.Options
options.DocumentCapabilities.Hyperlinks = DocumentCapability.Disabled
options.DocumentCapabilities.Numbering.Bulleted = DocumentCapability.Disabled

winforms-spreadsheetcontrol-api-part-3/VB/SpreadsheetControl_API_Part03/CodeUtils/ExampleCodeEditor.vb#L182

vb
Dim options As RichEditControlOptionsBase = codeEditor.InnerDocumentServer.Options
options.DocumentCapabilities.Hyperlinks = DocumentCapability.Disabled
options.DocumentCapabilities.Numbering.Bulleted = DocumentCapability.Disabled

See Also

DocumentCapabilitiesOptions Class

DocumentCapabilitiesOptions Members

DevExpress.XtraRichEdit Namespace