Class AbstractSourceAndTargetFileRefreshablePreviewController

Inheritance
object
AbstractSourceAndTargetFileRefreshablePreviewController
Implements
Inherited Members
Namespace: Sdl.FileTypeSupport.Framework.IntegrationApi
Assembly: Sdl.FileTypeSupport.Framework.Core.dll
Syntax
public abstract class AbstractSourceAndTargetFileRefreshablePreviewController : ISourceAndTargetFileRefreshablePreview, ISourceAndTargetFilePreviewControl, IAbstractPreviewControl, IAbstractPreviewController, ISourceAndTargetFilePreviewController, INavigablePreview, IDisposable, IPreviewUpdatedViaRefresh, IAbstractUpdatablePreview

Constructors

AbstractSourceAndTargetFileRefreshablePreviewController()

Declaration
protected AbstractSourceAndTargetFileRefreshablePreviewController()

Properties

Control

Declaration
public virtual Control Control { get; }
Property Value
Type Description
Control

PreferredHighlightColor

Set by the host application to indicate the preferred color to be used for highlighting the current segment in the preview when NavigateToSegment(SegmentReference) is called.

Declaration
public virtual Color PreferredHighlightColor { get; set; }
Property Value
Type Description
Color
Remarks

Using the highlight color is optional, but leads to an enhanced user experience. This will typically be the same color as the background color that is used for the active segment row in the editor, which makes it easier for the user to see that the two segments (i.e. from the bilingual document and the preview) relate to each other.

RefreshPreview

Declaration
public bool RefreshPreview { get; set; }
Property Value
Type Description
bool

SourcePreviewFile

Full path to the source language file. This should be set by the application before the first call to Launch() or IAbstractPreviewControl.Refresh.

Declaration
public virtual TempFileManager SourcePreviewFile { get; set; }
Property Value
Type Description
TempFileManager
Remarks

The file is passed through a temporary file manager, which means that it should be deleted automatically when it is no longer needed.

TargetFilePath

Full path to the target language file that is overwritten when the preview is refreshed. This path is typically set once and stays unchanged during the lifetime of the preview.

Declaration
public virtual TempFileManager TargetFilePath { get; set; }
Property Value
Type Description
TempFileManager

TargetPreviewFile

Full path to the target language file, which should be set by the application before the first call to Launch() or IAbstractPreviewControl.Refresh.

Declaration
public virtual TempFileManager TargetPreviewFile { get; set; }
Property Value
Type Description
TempFileManager
Remarks

The file is passed through a temporary file manager, which means that it should automatically get deleted when no longer needed.

Methods

AfterFileRefresh()

Called by the host application after the preview file has been successfully overwritten.

Declaration
public virtual void AfterFileRefresh()
Remarks

The implementation typically re-loads (refreshes) the file in the preview and (if necessary) navigates to the previously displaying content.

BeforeFileRefresh()

Called by the host application when the preview is about to be updated, before the file at TargetFilePath is overwritten.

Declaration
public virtual void BeforeFileRefresh()
Remarks

This call allows the implementation to release any file locks and/or try to 'remember' the current location of the file before it is overwritten.

Dispose()

Declaration
public virtual void Dispose()

NavigateToSegment(SegmentReference)

Called by the host application to request that the preview should scroll to the specified segment.

Declaration
public virtual void NavigateToSegment(SegmentReference segment)
Parameters
Type Name Description
SegmentReference segment
Remarks

The implementation may specifically highlight the segment in the preview (if possible).

OnSegmentSelected(SegmentSelectedEventArgs)

Declaration
public void OnSegmentSelected(SegmentSelectedEventArgs args)
Parameters
Type Name Description
SegmentSelectedEventArgs args

Refresh()

Declaration
public virtual void Refresh()

Events

SegmentSelected

Raised when the user interacts with the preview, selecting a different segment than the one that is currently highlighted.

Declaration
public event EventHandler<SegmentSelectedEventArgs> SegmentSelected
Event Type
Type Description
EventHandler<SegmentSelectedEventArgs>
Remarks

The host application typically handles this event by changing the active segment in the editor to the one that the user has selected in the preview.

Implements