AnnotationService.Enable(AnnotationStore) 方法

定義

命名空間:

System.Windows.Annotations

組件:

PresentationFramework.dll

讓 AnnotationService 可以搭配特定的 AnnotationStore 使用並顯示所有可見的附註。

public:
 void Enable(System::Windows::Annotations::Storage::AnnotationStore ^ annotationStore);

public void Enable (System.Windows.Annotations.Storage.AnnotationStore annotationStore);

member this.Enable : System.Windows.Annotations.Storage.AnnotationStore -> unit

Public Sub Enable (annotationStore As AnnotationStore)

參數

annotationStore

AnnotationStore

附註存放區，用來讀取、寫入和顯示附註。

例外狀況

ArgumentNullException

annotationStore 為 null。

範例

下列範例示範如何在您啟動 AnnotationService 時使用 Enable 方法。

// ------------------------ 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

備註

當 Enable 呼叫 檢視器控制項視窗中的所有批註時都會顯示。 (在建構函式的參數 AnnotationService 中指定與批註服務相關聯的檢視器控制項。)

另請參閱

• Disable()
• IsEnabled