Metodo IInkRecognitionAlternate::AlternatesWithConstantPropertyValues (msinkaut.h)

Articolo
03/05/2024

Recupera un insieme IInkRecognitionAlternates , che sono una divisione dell'oggetto IInkRecognitionAlternate su cui viene chiamato questo metodo.

Sintassi

HRESULT AlternatesWithConstantPropertyValues(
  [in]          BSTR                      PropertyType,
  [out, retval] IInkRecognitionAlternates **AlternatesWithConstantPropertyValues
);

Parametri

[in] PropertyType

Specifica un valore stringa che identifica la proprietà. Per un elenco delle proprietà che è possibile usare, vedere RecognitionProperty.

Per altre informazioni sul tipo di dati BSTR, vedere Uso della libreria COM.

[out, retval] AlternatesWithConstantPropertyValues

Quando termina, questo metodo contiene un insieme IInkRecognitionAlternates costituito da una divisione dell'alternativa su cui viene chiamato questo metodo. Ogni oggetto IInkRecognitionAlternate nell'insieme contiene segmenti di riconoscimento adiacenti che hanno lo stesso valore della proprietà per il parametro propertyType .

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Un parametro contiene un puntatore non valido.
E_INVALIDARG	L'intervallo di riconoscimento non è valido.
E_INK_EXCEPTION	Eccezione durante l'elaborazione.
E_OUTOFMEMORY	Impossibile allocare memoria per completare l'operazione.

Commenti

Ogni alternativa nell'insieme contiene segmenti di riconoscimento adiacenti che hanno lo stesso valore della proprietà passata nel metodo .

Ad esempio, è possibile restituire alternative che dividono l'originale alternativo per:

Livello di limite di confidenza forte, intermedio o scarso nel risultato del riconoscimento.
Limiti di linea.
Limiti dei segmenti di riconoscimento.

Per un elenco completo dei tipi di proprietà, vedere RecognitionProperty.

Nota Il riconoscitore determina la segmentazione dei tratti nei segmenti di riconoscimento. Alcuni segmenti di riconoscimento, ad esempio spazi, possono corrispondere a una raccolta InkStrokes vuota.

Nota Il riconoscitore determina l'ordinamento dei segmenti di riconoscimento. Pertanto, i segmenti di riconoscimento adiacenti possono essere basati sull'ordine in cui è stato disegnato l'inchiostro o in base alla posizione, ad esempio se è posizionato da sinistra a destra, posizionato dall'alto verso il basso e così via.

La proprietà ConfidenceAlternates è un'alternativa al metodo AlternatesWithConstantPropertyValues , dove ConfidenceLevel è recognitionProperty che separa le alternative nell'insieme di alternative di riconoscimento restituito.

La proprietà LineAlternates è un'alternativa al metodo AlternatesWithConstantPropertyValues , dove LineNumber è il RecognitionProperty che separa le alternative nell'insieme di alternative di riconoscimento restituito.

Nota Il metodo AlternatesWithConstantPropertyValues , la proprietà LineAlternates e la proprietà ConfidenceAlternates della funzione oggetto IInkRecognitionAlternate diversamente dal metodo AlternatesFromSelection dell'oggetto IInkRecognitionResult . AlternatesFromSelection restituisce una raccolta di alternative per i segmenti richiesti del risultato del riconoscimento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	msinkaut.h
Libreria	InkObj.dll