InkAnalyzerBase.ModifyTopAlternate (Método) (AnalysisAlternateBase, Boolean)

Artículo
11/26/2008

Actualización: noviembre 2007

Cambia la alternativa principal actual por el objeto AnalysisAlternateBase especificado.

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

Sintaxis

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

Parámetros

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

confirmAutomatically
Tipo: System.Boolean
true para establecer todos los nodos de contexto hoja de entrada manuscrita que corresponden al objeto de alternativa de análisis de forma que tengan aplicada una propiedad confirmada de NodeTypeAndProperties; false para establecer todos los nodos de contexto hoja de entrada manuscrita que corresponden al objeto de alternativa de análisis de forma que tengan aplicada una propiedad confirmada de None.

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