AnnotationService 建構函式

定義

命名空間:

System.Windows.Annotations

組件:

PresentationFramework.dll

初始化 AnnotationService 類別的新執行個體，以搭配指定的文件檢視控制項使用。

多載

AnnotationService(FlowDocumentReader)	初始化 AnnotationService 類別的新執行個體，以搭配指定的 FlowDocumentReader 控制項使用。
AnnotationService(FlowDocumentScrollViewer)	初始化 AnnotationService 類別的新執行個體，以搭配指定的 FlowDocumentScrollViewer 控制項使用。
AnnotationService(DocumentViewerBase)	初始化 AnnotationService 類別的新執行個體，以搭配指定的 DocumentViewer 或 FlowDocumentPageViewer 控制項使用。

範例

下列範例顯示建構函式的使用 AnnotationService 方式。

// ------------------------ StartAnnotations --------------------------
/// <summary>
///   Enables annotations and displays all that are viewable.</summary>
private void StartAnnotations()
{
    // If there is no AnnotationService yet, create one.
    if (_annotService == null)
        // docViewer is a document viewing control named in Window1.xaml.
        _annotService = new AnnotationService(docViewer);

    // If the AnnotationService is currently enabled, disable it.
    if (_annotService.IsEnabled == true)
        _annotService.Disable();

    // Open a stream to the file for storing annotations.
    _annotStream = new FileStream(
        _annotStorePath, FileMode.OpenOrCreate, FileAccess.ReadWrite);

    // Create an AnnotationStore using the file stream.
    _annotStore = new XmlStreamStore(_annotStream);

    // Enable the AnnotationService using the new store.
    _annotService.Enable(_annotStore);
}// end:StartAnnotations()

' ------------------------ StartAnnotations --------------------------
''' <summary>
'''   Enables annotations and displays all that are viewable.</summary>
Private Sub StartAnnotations()
    ' If there is no AnnotationService yet, create one.
    If _annotService Is Nothing Then
        ' docViewer is a document viewing control named in Window1.xaml.
        _annotService = New AnnotationService(docViewer)
    End If

    ' If the AnnotationService is currently enabled, disable it.
    If _annotService.IsEnabled = True Then
        _annotService.Disable()
    End If

    ' Open a stream to the file for storing annotations.
    _annotStream = New FileStream(_annotStorePath, FileMode.OpenOrCreate, FileAccess.ReadWrite)

    ' Create an AnnotationStore using the file stream.
    _annotStore = New XmlStreamStore(_annotStream)

    ' Enable the AnnotationService using the new store.
    _annotService.Enable(_annotStore)
End Sub

備註

AnnotationService可以搭配下列檔檢視控制項使用：

• FlowDocumentReader

• FlowDocumentScrollViewer

• DocumentViewerBase 衍生的子類別

  • DocumentViewer

  • FlowDocumentPageViewer

AnnotationService(FlowDocumentReader)

初始化 AnnotationService 類別的新執行個體，以搭配指定的 FlowDocumentReader 控制項使用。

public:
 AnnotationService(System::Windows::Controls::FlowDocumentReader ^ viewer);

public AnnotationService (System.Windows.Controls.FlowDocumentReader viewer);

new System.Windows.Annotations.AnnotationService : System.Windows.Controls.FlowDocumentReader -> System.Windows.Annotations.AnnotationService

Public Sub New (viewer As FlowDocumentReader)

參數

viewer

FlowDocumentReader

與 AnnotationService 關聯的文件讀取控制項。

範例

下列範例顯示建構函式的使用 AnnotationService 方式。

// ------------------------ StartAnnotations --------------------------
/// <summary>
///   Enables annotations and displays all that are viewable.</summary>
private void StartAnnotations()
{
    // If there is no AnnotationService yet, create one.
    if (_annotService == null)
        // docViewer is a document viewing control named in Window1.xaml.
        _annotService = new AnnotationService(docViewer);

    // If the AnnotationService is currently enabled, disable it.
    if (_annotService.IsEnabled == true)
        _annotService.Disable();

    // Open a stream to the file for storing annotations.
    _annotStream = new FileStream(
        _annotStorePath, FileMode.OpenOrCreate, FileAccess.ReadWrite);

    // Create an AnnotationStore using the file stream.
    _annotStore = new XmlStreamStore(_annotStream);

    // Enable the AnnotationService using the new store.
    _annotService.Enable(_annotStore);
}// end:StartAnnotations()

' ------------------------ StartAnnotations --------------------------
''' <summary>
'''   Enables annotations and displays all that are viewable.</summary>
Private Sub StartAnnotations()
    ' If there is no AnnotationService yet, create one.
    If _annotService Is Nothing Then
        ' docViewer is a document viewing control named in Window1.xaml.
        _annotService = New AnnotationService(docViewer)
    End If

    ' If the AnnotationService is currently enabled, disable it.
    If _annotService.IsEnabled = True Then
        _annotService.Disable()
    End If

    ' Open a stream to the file for storing annotations.
    _annotStream = New FileStream(_annotStorePath, FileMode.OpenOrCreate, FileAccess.ReadWrite)

    ' Create an AnnotationStore using the file stream.
    _annotStore = New XmlStreamStore(_annotStream)

    ' Enable the AnnotationService using the new store.
    _annotService.Enable(_annotStore)
End Sub

另請參閱

• GetService(FlowDocumentReader)

AnnotationService(FlowDocumentScrollViewer)

初始化 AnnotationService 類別的新執行個體，以搭配指定的 FlowDocumentScrollViewer 控制項使用。

public:
 AnnotationService(System::Windows::Controls::FlowDocumentScrollViewer ^ viewer);

public AnnotationService (System.Windows.Controls.FlowDocumentScrollViewer viewer);

new System.Windows.Annotations.AnnotationService : System.Windows.Controls.FlowDocumentScrollViewer -> System.Windows.Annotations.AnnotationService

Public Sub New (viewer As FlowDocumentScrollViewer)

參數

viewer

FlowDocumentScrollViewer

與 AnnotationService 關聯的文件檢視控制項。

例外狀況

ArgumentNullException

viewer 為 null。

範例

下列範例顯示建構函式的使用 AnnotationService 方式。

// ------------------------ StartAnnotations --------------------------
/// <summary>
///   Enables annotations and displays all that are viewable.</summary>
private void StartAnnotations()
{
    // If there is no AnnotationService yet, create one.
    if (_annotService == null)
        // docViewer is a document viewing control named in Window1.xaml.
        _annotService = new AnnotationService(docViewer);

    // If the AnnotationService is currently enabled, disable it.
    if (_annotService.IsEnabled == true)
        _annotService.Disable();

    // Open a stream to the file for storing annotations.
    _annotStream = new FileStream(
        _annotStorePath, FileMode.OpenOrCreate, FileAccess.ReadWrite);

    // Create an AnnotationStore using the file stream.
    _annotStore = new XmlStreamStore(_annotStream);

    // Enable the AnnotationService using the new store.
    _annotService.Enable(_annotStore);
}// end:StartAnnotations()

' ------------------------ StartAnnotations --------------------------
''' <summary>
'''   Enables annotations and displays all that are viewable.</summary>
Private Sub StartAnnotations()
    ' If there is no AnnotationService yet, create one.
    If _annotService Is Nothing Then
        ' docViewer is a document viewing control named in Window1.xaml.
        _annotService = New AnnotationService(docViewer)
    End If

    ' If the AnnotationService is currently enabled, disable it.
    If _annotService.IsEnabled = True Then
        _annotService.Disable()
    End If

    ' Open a stream to the file for storing annotations.
    _annotStream = New FileStream(_annotStorePath, FileMode.OpenOrCreate, FileAccess.ReadWrite)

    ' Create an AnnotationStore using the file stream.
    _annotStore = New XmlStreamStore(_annotStream)

    ' Enable the AnnotationService using the new store.
    _annotService.Enable(_annotStore)
End Sub

另請參閱

• GetService(FlowDocumentScrollViewer)

AnnotationService(DocumentViewerBase)

初始化 AnnotationService 類別的新執行個體，以搭配指定的 DocumentViewer 或 FlowDocumentPageViewer 控制項使用。

public:
 AnnotationService(System::Windows::Controls::Primitives::DocumentViewerBase ^ viewer);

public AnnotationService (System.Windows.Controls.Primitives.DocumentViewerBase viewer);

new System.Windows.Annotations.AnnotationService : System.Windows.Controls.Primitives.DocumentViewerBase -> System.Windows.Annotations.AnnotationService

Public Sub New (viewer As DocumentViewerBase)

參數

viewer

DocumentViewerBase

與 AnnotationService 關聯的文件檢視控制項。

例外狀況

ArgumentNullException

viewer 為 null。

範例

下列範例顯示建構函式的使用 AnnotationService 方式。

// ------------------------ StartAnnotations --------------------------
/// <summary>
///   Enables annotations and displays all that are viewable.</summary>
private void StartAnnotations()
{
    // If there is no AnnotationService yet, create one.
    if (_annotService == null)
        // docViewer is a document viewing control named in Window1.xaml.
        _annotService = new AnnotationService(docViewer);

    // If the AnnotationService is currently enabled, disable it.
    if (_annotService.IsEnabled == true)
        _annotService.Disable();

    // Open a stream to the file for storing annotations.
    _annotStream = new FileStream(
        _annotStorePath, FileMode.OpenOrCreate, FileAccess.ReadWrite);

    // Create an AnnotationStore using the file stream.
    _annotStore = new XmlStreamStore(_annotStream);

    // Enable the AnnotationService using the new store.
    _annotService.Enable(_annotStore);
}// end:StartAnnotations()

' ------------------------ StartAnnotations --------------------------
''' <summary>
'''   Enables annotations and displays all that are viewable.</summary>
Private Sub StartAnnotations()
    ' If there is no AnnotationService yet, create one.
    If _annotService Is Nothing Then
        ' docViewer is a document viewing control named in Window1.xaml.
        _annotService = New AnnotationService(docViewer)
    End If

    ' If the AnnotationService is currently enabled, disable it.
    If _annotService.IsEnabled = True Then
        _annotService.Disable()
    End If

    ' Open a stream to the file for storing annotations.
    _annotStream = New FileStream(_annotStorePath, FileMode.OpenOrCreate, FileAccess.ReadWrite)

    ' Create an AnnotationStore using the file stream.
    _annotStore = New XmlStreamStore(_annotStream)

    ' Enable the AnnotationService using the new store.
    _annotService.Enable(_annotStore)
End Sub

備註

此建構函式可以搭配 DocumentViewerBase 衍生控制項使用：

• DocumentViewer

• FlowDocumentPageViewer

另請參閱

• Disable()
• GetService(DocumentViewerBase)