Bagikan melalui


Antarmuka IContextNode

Mewakili simpul di pohon objek yang dibuat sebagai bagian dari analisis tinta.

Anggota

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

Metode

Antarmuka IContextNode memiliki metode ini.

Metode Deskripsi
AddContextLink Menambahkan IContextLink baru ke koleksi tautan konteks objek IContextNode .
AddPropertyData Menambahkan sepotong data khusus aplikasi.
Konfirmasikan Memodifikasi jenis konfirmasi, yang mengontrol apa yang dapat diubah objek IInkAnalyzer tentang IContextNode.
ContainsPropertyData Menentukan apakah objek IContextNode berisi data yang disimpan di bawah pengidentifikasi yang ditentukan.
CreatePartiallyPopulatedSubNode Membuat objek IContextNode anak yang hanya berisi informasi tentang jenis, pengidentifikasi, dan lokasi.
CreateSubNode Membuat objek IContextNode anak baru.
DeleteContextLink Menghapus objek IContextLink dari koleksi tautan objek IContextNode .
DeleteSubNode Menghapus IContextNode anak.
GetContextLinks Mengambil kumpulan objek IContextLink yang mewakili hubungan dengan objek IContextNode lainnya.
GetId Mengambil pengidentifikasi untuk objek IContextNode .
GetLocation Mengambil posisi dan ukuran objek IContextNode .
GetParentNode Mengambil simpul induk IContextNode ini di pohon simpul konteks.
GetPartiallyPopulated Mengambil nilai yang menunjukkan apakah objek IContextNode diisi sebagian atau diisi sepenuhnya.
GetPropertyData Mengambil data khusus aplikasi atau data properti lain yang diberikan pengidentifikasi yang ditentukan.
GetPropertyDataIds Mengambil pengidentifikasi yang data propertinya ada.
GetStrokeCount Mengambil jumlah goresan yang terkait dengan objek IContextNode .
GetStrokeId Mengambil pengidentifikasi stroke untuk goresan yang dirujuk oleh nilai indeks dalam objek IContextNode .
GetStrokeIds Mengambil array pengidentifikasi untuk goresan dalam objek IContextNode .
GetStrokePacketDataById Mengambil array yang berisi data properti paket untuk goresan yang ditentukan.
GetStrokePacketDescriptionById Mengambil array yang berisi pengidentifikasi properti paket untuk goresan yang ditentukan.
GetSubNodes Mengambil simpul anak langsung dari objek IContextNode .
GetType Mengambil jenis objek IContextNode .
GetTypeName Mengambil nama jenis yang dapat dibaca manusia dari IContextNode ini.
IsConfirmed Mengambil nilai yang menunjukkan apakah objek IContextNode dikonfirmasi. IInkAnalyzer tidak dapat mengubah jenis node dan goresan terkait untuk objek IContextNode yang dikonfirmasi.
LoadPropertiesData Membuat ulang data properti khusus aplikasi dan internal untuk array byte yang sebelumnya dibuat dengan IContextNode::SavePropertiesData.
MoveSubNodeToPosition Menyusun ulang objek IContextNode anak tertentu ke indeks yang ditentukan.
RemovePropertyData Menghapus sepotong data khusus aplikasi.
Reparent Memindahkan objek IContextNode ini dari kumpulan subnode simpul konteks induknya ke kumpulan subnode simpul konteks yang ditentukan.
ReparentStrokeByIdToNode Memindahkan data stroke dari IContextNode ini ke IContextNode yang ditentukan.
SavePropertiesData Mengambil array byte yang berisi data properti khusus aplikasi dan internal untuk IContextNode ini.
SetLocation Updates posisi dan ukuran IContextNode ini.
SetPartiallyPopulated Memodifikasi nilai yang menunjukkan apakah IContextNode ini diisi sebagian atau sepenuhnya.
SetStrokes Mengaitkan goresan yang ditentukan dengan IContextNode ini.

Keterangan

Jenis simpul dijelaskan dalam konstanta Jenis Simpul Konteks .

Contoh

Contoh berikut menunjukkan metode yang memeriksa IContextNode; metode melakukan hal berikut:

  • Mendapatkan jenis simpul konteks. Jika simpul konteks adalah tinta yang tidak diklasifikasikan, petunjuk analisis, atau simpul pengenal kustom, simpul ini memanggil metode pembantu untuk memeriksa properti tertentu dari jenis node.
  • Jika simpul memiliki subnode, simpul memeriksa setiap subnode dengan memanggil dirinya sendiri.
  • Jika simpul adalah simpul daun tinta, node memeriksa data stroke untuk simpul dengan memanggil metode pembantu.

Ihe InkAnalysis API memungkinkan Anda membuat simpul baris yang berisi kata-kata tinta dan kata teks. Namun, parser akan mengabaikan node campuran ini dan akan memperlakukannya seperti node asing. Ini akan berdampak pada akurasi penguraian deteksi anotasi tinta ketika pengguna akhir menulis pada atau di sekitar simpul campuran ini.

HRESULT CMyClass::ExploreContextNode(
    IContextNode *pContextNode)
{
    // Check for certain types of context nodes.
    GUID ContextNodeType;
    HRESULT hr = pContextNode->GetType(&ContextNodeType);

    if (SUCCEEDED(hr))
    {
        if (IsEqualGUID(GUID_CNT_UNCLASSIFIEDINK, ContextNodeType))
        {
            // Call a helper method that explores unclassified ink nodes.
            hr = this->ExploreUnclassifiedInkNode(pContextNode);
        }
        else if (IsEqualGUID(GUID_CNT_ANALYSISHINT, ContextNodeType))
        {
            // Call a helper method that explores analysis hint nodes.
            hr = this->ExploreAnalysisHintNode(pContextNode);
        }
        else if (IsEqualGUID(GUID_CNT_CUSTOMRECOGNIZER, ContextNodeType))
        {
            // Call a helper method that explores custom recognizer nodes.
            hr = this->ExploreCustomRecognizerNode(pContextNode);
        }

        if (SUCCEEDED(hr))
        {
            // Check if this node is a branch or a leaf node.
            IContextNodes *pSubNodes = NULL;
            hr = pContextNode->GetSubNodes(&pSubNodes);

            if (SUCCEEDED(hr))
            {
                ULONG ulSubNodeCount;
                hr = pSubNodes->GetCount(&ulSubNodeCount);

                if (SUCCEEDED(hr))
                {
                    if (ulSubNodeCount > 0)
                    {
                        // This node has child nodes; explore each child node.
                        IContextNode *pSubNode = NULL;
                        for (ULONG index=0; index<ulSubNodeCount; index++)
                        {
                            hr = pSubNodes->GetContextNode(index, &pSubNode);

                            if (SUCCEEDED(hr))
                            {
                                // Recursive call to explore the child node of this
                                // context node.
                                hr = this->ExploreContextNode(pSubNode);
                            }

                            // Release this reference to the child context node.
                            if (pSubNode != NULL)
                            {
                                pSubNode->Release();
                                pSubNode = NULL;
                            }

                            if (FAILED(hr))
                            {
                                break;
                            }
                        }
                    }
                    else
                    {
                        // This is a leaf node. Check if it contains stroke data.
                        ULONG ulStrokeCount;
                        hr = pContextNode->GetStrokeCount(&ulStrokeCount);

                        if (SUCCEEDED(hr))
                        {
                            if (ulStrokeCount > 0)
                            {
                                // This node is an ink leaf node; call helper
                                // method that explores available stroke data.
                                hr = this->ExploreNodeStrokeData(pContextNode);
                            }
                        }
                    }
                }
            }

            // Release this reference to the subnodes collection.
            if (pSubNodes != NULL)
            {
                pSubNodes->Release();
                pSubNodes = 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

IContextNodes

Jenis Simpul Konteks

IInkAnalyzer

Referensi Analisis Tinta