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