HPDFXFAResolveFieldValueNode

Birim: HPDFXFA

Bildirim

function HPDFXFAResolveFieldValueNode(Document: TXFADocument;
  FieldNode, DataNode: TXFANode; CreateNode: Boolean= False;
  MaxNodes: Integer= 65536): TXFANode; overload;

function HPDFXFAResolveFieldValueNode(Document: TXFADocument;
  FieldNode, DataNode: TXFANode; CreateNode: Boolean;
  MaxNodes: Integer; var RemainingOperations: Integer; Deadline: Int64;
  DeadlineCheck: TXFABindingDeadlineCheck = nil): TXFANode; overload;

Parametreler

Parametre	Anlam
`Document`	Alanı, veriyi ve form packet'lerine sahip native XFA belgesi
`FieldNode`	Etkin değeri istenen template alanı
`DataNode`	Dataset occurrence bağlamı; tekrarlanan alanlar kendi occurrence bağlamlarını gerektirir
`CreateNode`	False, okunabilir veriyi, bir form değerini veya template varsayılanını çözer; True, yazılabilir bir instance değeri döndürür
`MaxNodes`	Native form instance oluşturmasına geçilen occurrence sınırı

Davranış

Mevcut bağlı bir dataset node'u, içeriği boş olsa bile kazanır; eksik bir node, karşılık gelen native form değerine ve sonra template alanındaki ilk değer çocuğuna düşer

Salt-okunur bir arama, dataset veya form node oluşturmaz ve bu değer kaynaklarından hiçbiri yokken nil döndürür

CreateNode True ile normal data bağlaması, yazılabilir dataset node'unu oluşturur veya döndürür; bağlı olmayan bir alan veya yazılabilir datasets'i olmayan bir belge, bunun yerine ayrı bir native form değeri kullanır

Yeni oluşturulan bir dataset node'u başlangıçta boş olabilir; çağıran, daha önce döndürülmüş bir template varsayılanı üzerinden atama yapmak yerine kesinleştirilmiş değeri sağlar

Döndürülen node Document'e aittir ve çağıran tarafından free edilmemelidir; salt-okunur arama, paylaşılan bir template node döndürebilir; bu yüzden içeriğini değiştirmeden önce CreateNode True ile yazılabilir bir node alın

Null Document veya FieldNode, nil döndürür; aşırı native form occurrence indeksleri veya ata derinliği, form resolver üzerinden EHPDFXFAError fırlatır

Tüketiciler

Bütçeli overload, çağıranın işlem payını ve son tarihini native bağlama çözümüyle paylaşır; sıfır RemainingOperations tükenmiştir, negatif çağıran payını devre dışı bırakır ve negatif Deadline geçen-süre denetimlerini devre dışı bırakır

DeadlineCheck, çağıranın saat alanını sağlayabilir; nil GetTickCount64 milisaniyelerini kullanırken etkileşimli runtime, yapılandırılmış monotonik son-tarihi denetimini sağlar

Bağlama taramaları, sabit segment, traversal derinliği ve düşülmüş-adım sınırlarını korur; bütçe hataları EHPDFXFAError fırlatır ve etkileşimli transaction'lar native anlık görüntülerini geri yükler

Bağlama bütçesi ve callback sözleşmeleri için bkz. HPDFXFAResolveBoundDataNode ve TXFABindingDeadlineCheck

Etkileşimli runtime ve XFA AcroForm dönüşümü bu resolver'ı paylaşır; eksik varsayılanları, açıkça boş veriyi ve tekrarlanan occurrence değerlerini tutarlı tutarak

Etkileşimli düzenlemeler ve hesaplamalar, kesinleştirmeden önce yazılabilir bir instance node'u yeniden alır; diğer instance'lar için template varsayılanını koruyarak

İlgili API'ler

Native XFA Alan Varsayılanları, HPDFXFAResolveFormInstanceNode ve Interactive Dynamic XFA Widget Runtime