InkAnalyzerBase.ModifyTopAlternate-Methode (AnalysisAlternateBase, Boolean)

Artikel
11/26/2008

Ändert die aktuelle erste Alternative in die angegebene AnalysisAlternateBase.

Namespace: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)

Syntax

'Declaration
Public Function ModifyTopAlternate ( _
    alternate As AnalysisAlternateBase, _
    confirmAutomatically As Boolean _
) As Boolean
'Usage
Dim instance As InkAnalyzerBase
Dim alternate As AnalysisAlternateBase
Dim confirmAutomatically As Boolean
Dim returnValue As Boolean

returnValue = instance.ModifyTopAlternate(alternate, _
    confirmAutomatically)

public bool ModifyTopAlternate(
    AnalysisAlternateBase alternate,
    bool confirmAutomatically
)

public:
bool ModifyTopAlternate(
    AnalysisAlternateBase^ alternate, 
    bool confirmAutomatically
)

public boolean ModifyTopAlternate(
    AnalysisAlternateBase alternate,
    boolean confirmAutomatically
)

public function ModifyTopAlternate(
    alternate : AnalysisAlternateBase, 
    confirmAutomatically : boolean
) : boolean

Parameter

alternate
Typ: System.Windows.Ink.AnalysisCore.AnalysisAlternateBase
Die Alternative, die als erste Alternative festgelegt werden soll.

confirmAutomatically
Typ: System.Boolean
true , um alle Freihandendkontextknoten festzulegen, die dem Objekt der Analysealternative entsprechen, damit auf sie eine bestätigte Eigenschaft von NodeTypeAndProperties angewendet wird; false, um alle Freihandendkontextknoten festzulegen, die dem Objekt der Analysealternative entsprechen, damit auf sie eine bestätigte Eigenschaft von None angewendet wird.

Rückgabewert

Typ: System.Boolean

Hinweise

Verwenden Sie GetAlternates, um Analysealternativen abzurufen. Verwenden Sie AnalysisAlternateBase.AlternateNodes, um die einer Analysealternative zugeordneten Kontextknoten abzurufen.

Verwenden Sie ContextNodeBase.Confirm, um den Bestätigungstyp für einen Kontextknoten zu ändern.

Beispiele

Im folgenden Beispiel wird die oberste Alternative für die ContextNodeBaseCollection mit dem Namen theLineNodes geändert. In diesem Beispiel enthält theLineNodes ausgewählte Line-Knoten von der InkAnalyzerBase namens theInkAnalyzerBase. Der boolesche Wert confirmationEnabled gibt an, ob die Anwendung die Knotenbestätigung aktiviert hat. Wenn die Anwendung die Knotenbestätigung aktiviert hat, gibt der boolesche Wert confirmAutomatically an, ob der vorhandene Bestätigungstyp gelöscht oder beibehalten wurde.

Im folgenden Beispiel wird eine Hilfsmethode SelectAnalysisAlternate verwendet, um die Analysealternative auszuwählen, die als oberste Alternative festgelegt werden soll.

' Get alternates for the specified line nodes.
Dim theAlternates As System.Windows.Ink.AnalysisCore.AnalysisAlternateBaseCollection = _
    theInkAnalyzerBase.GetAlternates(theLineNodes)

' Use a helper method to get the user's choice of alternate.
Dim selectedAlternate As System.Windows.Ink.AnalysisCore.AnalysisAlternateBase = _
    Me.SelectAnalysisAlternate(theAlternates)

' Set the chosen alternate as the top alternate.
If confirmationEnabled Then
    ' If node confirmation is enabled, use the current setting
    ' of confirmAutomatically to keep or clear the existing
    ' confirmation status of the line nodes.
    theInkAnalyzerBase.ModifyTopAlternate( _
        selectedAlternate, confirmAutomatically)
Else
    ' Otherwise, clear the confirmation as part of modifying
    ' the top alternate.
    theInkAnalyzerBase.ModifyTopAlternate(selectedAlternate)
End If

// Get alternates for the specified line nodes.
System.Windows.Ink.AnalysisCore.AnalysisAlternateBaseCollection theAlternates =
    theInkAnalyzerBase.GetAlternates(theLineNodes);

// Use a helper method to get the user's choice of alternate.
System.Windows.Ink.AnalysisCore.AnalysisAlternateBase selectedAlternate =
    this.SelectAnalysisAlternate(theAlternates);

// Set the chosen alternate as the top alternate.
if (confirmationEnabled)
{
    // If node confirmation is enabled, use the current setting
    // of confirmAutomatically to keep or clear the existing
    // confirmation status of the line nodes.
    theInkAnalyzerBase.ModifyTopAlternate(
        selectedAlternate, confirmAutomatically);
}
else
{
    // Otherwise, clear the confirmation as part of modifying
    // the top alternate.
    theInkAnalyzerBase.ModifyTopAlternate(selectedAlternate);
}

Plattformen

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.