Antarmuka IAnalysisWarning

Mewakili peringatan atau kesalahan yang terjadi selama operasi analisis tinta.

Anggota

Antarmuka IAnalysisWarning mewarisi dari antarmuka IUnknown . IAnalysisWarning juga memiliki jenis anggota ini:

• Metode

Metode

Antarmuka IAnalysisWarning memiliki metode ini.

Metode	Deskripsi
GetBackgroundError	Mengambil kode kesalahan untuk operasi analisis tinta latar belakang jika terjadi kesalahan.
GetHint	Mengambil petunjuk analisis yang menyebabkan peringatan ini
GetNodeIds	Mengambil pengidentifikasi simpul konteks relevan apa pun yang terkait dengan peringatan ini.
GetWarningCode	Mengambil jenis peringatan yang terjadi dengan menggunakan enumerasi AnalysisWarningCode .

Keterangan

Jenis peringatan yang dapat terjadi dijelaskan oleh enumerasi AnalysisWarningCode . Seringkali peringatan terjadi ketika Anda mencoba menggunakan fitur yang tidak didukung oleh IInkAnalysisRecognizer yang digunakan IInkAnalyzer .

Beberapa peringatan menunjukkan bahwa IInkAnalyzer tidak menyelesaikan operasi analisis. Untuk informasi selengkapnya, lihat AnalysisWarningCode.

Contoh

Contoh berikut menunjukkan kerangka penanganan aktivitas untuk peristiwa _IAnalysisEvents::Results . Handler memeriksa IAnalysisStatus::IsSuccessful. Jika operasi analisis menghasilkan peringatan, handler melakukan iterasi melalui pengumpulan objek IAnalysisWarning .

// _IAnalysisEvents::Results event handler.
STDMETHODIMP CMyClass::Results(
    IInkAnalyzer *pInkAnalyzer,
    IAnalysisStatus *pAnalysisStatus)
{
    // Check the status of the analysis operation.
    VARIANT_BOOL bResult = VARIANT_FALSE;
    HRESULT hr = pAnalysisStatus->IsSuccessful(&bResult);

    if( SUCCEEDED(hr) )
    {
        if( bResult )
        {
            // Insert code that handles a successful result.
        }
        else
        {
            // Get the analysis warnings.
            IAnalysisWarnings* pAnalysisWarnings = NULL;
            hr = pAnalysisStatus->GetWarnings(&pAnalysisWarnings);
            if (SUCCEEDED(hr))
            {
                // Iterate through the warning collection.
                ULONG warningCount = 0;
                hr = pAnalysisWarnings->GetCount(&warningCount);
                if (SUCCEEDED(hr))
                {
                    IAnalysisWarning *pAnalysisWarning = NULL;
                    AnalysisWarningCode analysisWarningCode;
                    for (ULONG index=0; index<warningCount; index++)
                    {
                        // Get an analysis warning.
                        hr = pAnalysisWarnings->GetAnalysisWarning(
                            index, &pAnalysisWarning);

                        if (SUCCEEDED(hr))
                        {
                            // Get the warning code for the warning.
                            hr = pAnalysisWarning->GetWarningCode(
                                &analysisWarningCode);

                            if (SUCCEEDED(hr))
                            {
                                // Insert code that handles each
                                // analysis warning.
                            }
                        }

                        // Release this reference to the analysis warning.
                        if (pAnalysisWarning != NULL)
                        {
                            pAnalysisWarning->Release();
                            pAnalysisWarning = NULL;
                        }

                        if (FAILED(hr))
                        {
                            break;
                        }
                    }
                }
            }

            // Release this reference to the analysis warnings collection.
            if (pAnalysisWarnings != NULL)
            {
                pAnalysisWarnings->Release();
                pAnalysisWarnings = NULL;
            }
        }
    }
    return hr;
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Header	IACom.h (juga memerlukan IACom_i.c)
DLL	IACom.dll

Lihat juga

IAnalysisWarnings

AnalysisWarningCode

Referensi Analisis Tinta