InkAnalyzerBase.ModifyTopAlternate-Methode (AnalysisAlternateBase)

Artikel
11/26/2008

Ändert die aktuelle erste Alternative in die angegebene AnalysisAlternateBase und löscht den Bestätigungstyp für alle der Alternative zugeordneten Kontextknoten.

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

Syntax

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

returnValue = instance.ModifyTopAlternate(alternate)

public bool ModifyTopAlternate(
    AnalysisAlternateBase alternate
)

public:
bool ModifyTopAlternate(
    AnalysisAlternateBase^ alternate
)

public boolean ModifyTopAlternate(
    AnalysisAlternateBase alternate
)

public function ModifyTopAlternate(
    alternate : AnalysisAlternateBase
) : boolean

Parameter

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

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