InkAnalyzerBase.ModifyTopAlternate (Método) (AnalysisAlternateBase)

Artículo
10/28/2008

Actualización: noviembre 2007

Cambia la mejor alternativa actual para el objeto AnalysisAlternateBase especificado y borra el tipo de confirmación para todos los nodos de contexto asociados a la alternativa.

Espacio de nombres: System.Windows.Ink.AnalysisCore
Ensamblado: IACore (en IACore.dll)

Sintaxis

'Declaración
Public Function ModifyTopAlternate ( _
    alternate As AnalysisAlternateBase _
) As Boolean
'Uso
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

Parámetros

alternate
Tipo: System.Windows.Ink.AnalysisCore.AnalysisAlternateBase
Alternativa que se va a establecer como alternativa principal.

Valor devuelto

Tipo: System.Boolean

Comentarios

Para obtener las alternativas de análisis, utilice GetAlternates. Para obtener los nodos de contexto asociados a una alternativa de análisis, utilice AnalysisAlternateBase.AlternateNodes.

Para cambiar el tipo de confirmación de un nodo de contexto, utilice Confirm.

Ejemplos

En el ejemplo siguiente se modifica la mejor alternativa para el objeto ContextNodeBaseCollection, theLineNodes. En este ejemplo, theLineNodes contiene nodos de línea seleccionados de InkAnalyzerBase, theInkAnalyzerBase. El valor booleano confirmationEnabled indica si la aplicación ha habilitado la confirmación de nodo. Si la aplicación ha habilitado la confirmación de nodo, el valor booleano confirmAutomatically indica si el tipo de confirmación existente se borra o se mantiene.

En el ejemplo, se utiliza un método auxiliar, SelectAnalysisAlternate, para seleccionar la alternativa de análisis que se establecerá como mejor alternativa.

' 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);
}

Plataformas

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.