FormField

FormField class

Tek bir form alanını temsil eder.

Daha fazla bilgi edinmek için şu adresi ziyaret edin:Form Alanlarıyla Çalışma belgeleme makalesi.

public class FormField : SpecialChar

Özellikleri

İsimTanım
CalculateOnExit { get; set; }Belirtilen form alanına yapılan başvurular, alandan çıkıldığında otomatik olarak güncelleniyorsa doğrudur.
CheckBoxSize { get; set; }Onay kutusunun boyutunu noktalar halinde alır veya ayarlar. Yalnızca şu durumlarda etkilidir:IsCheckBoxExactSize dırdoğru .
Checked { get; set; }Onay kutusu form alanının işaretli durumunu alır veya ayarlar. Bu özelliğin varsayılan değeriYANLIŞ .
CustomNodeId { get; set; }Özel düğüm tanımlayıcısını belirtir.
Default { get; set; }Onay kutusu form alanının varsayılan değerini alır veya ayarlar. Bu özellik için varsayılan değer şudur:YANLIŞ .
virtual Document { get; }Bu düğümün ait olduğu belgeyi alır.
DropDownItems { get; }Bir açılır form alanının öğelerine erişim sağlar.
DropDownSelectedIndex { get; set; }Açılır form alanında şu anda seçili öğeyi belirten dizini alır veya ayarlar.
Enabled { get; set; }Bir form alanı etkinleştirilmişse doğrudur.
EntryMacro { get; set; }Form alanı için bir giriş makrosu adı döndürür veya ayarlar.
ExitMacro { get; set; }Form alanı için bir çıkış makrosu adı döndürür veya ayarlar.
Font { get; }Bu nesnenin yazı tipi biçimlendirmesine erişim sağlar.
HelpText { get; set; }Form alanı odakta olduğunda ve kullanıcı F1’e bastığında bir ileti kutusunda görüntülenen metni döndürür veya ayarlar.
IsCheckBoxExactSize { get; set; }Metin kutusunun boyutunun otomatik mi yoksa açıkça mı belirtildiğini belirten Boole değerini alır veya ayarlar.
virtual IsComposite { get; }Geri Döndürürdoğru eğer bu düğüm diğer düğümleri içerebiliyorsa.
IsDeleteRevision { get; }Değişiklik izleme etkinleştirilmişken bu nesnenin Microsoft Word’de silinmesi durumunda doğru değerini döndürür.
IsFormatRevision { get; }Değişiklik izleme etkinleştirilmişken Microsoft Word’de nesnenin biçimlendirmesinin değiştirilmesi durumunda doğru değerini döndürür.
IsInsertRevision { get; }Bu nesnenin Microsoft Word’e değişiklik izleme etkinleştirilmişken eklenip eklenmediğini döndürür.
IsMoveFromRevision { get; }Geri Döndürürdoğru bu nesne Microsoft Word’de değişiklik izleme etkinleştirilmişken taşınırsa (silinirse).
IsMoveToRevision { get; }Geri Döndürürdoğru bu nesne Microsoft Word’de değişiklik izleme etkinleştirilmişken taşınırsa (eklenirse).
MaxLength { get; set; }Metin alanı için maksimum uzunluk. Uzunluk sınırlı olmadığında sıfır.
Name { get; set; }Form alan adını alır veya ayarlar.
NextSibling { get; }Bu düğümü hemen takip eden düğümü alır.
override NodeType { get; }Geri DöndürürFormField .
OwnHelp { get; set; }Bir form alanı odakta olduğunda ve kullanıcı F1’e bastığında bir ileti kutusunda görüntülenen metnin kaynağını belirtir.
OwnStatus { get; set; }Bir form alanı odakta olduğunda durum çubuğunda görüntülenen metnin kaynağını belirtir.
ParentNode { get; }Bu düğümün en yakın üst düğümünü alır.
ParentParagraph { get; }Üst öğeyi alırParagraph bu düğümün.
PreviousSibling { get; }Bu düğümden hemen önceki düğümü alır.
Range { get; }BirRangebu düğümde bulunan bir belgenin bölümünü temsil eden nesne.
Result { get; set; }Bu form alanının sonucunu temsil eden bir dize alır veya ayarlar.
StatusText { get; set; }Bir form alanı odakta olduğunda durum çubuğunda görüntülenen metni döndürür veya ayarlar.
TextInputDefault { get; set; }Bir metin form alanının varsayılan dizesini veya hesaplama ifadesini alır veya ayarlar.
TextInputFormat { get; set; }Bir metin form alanı için metin biçimlendirmesini döndürür veya ayarlar.
TextInputType { get; set; }Bir metin form alanının türünü alır veya ayarlar.
Type { get; }Form alan türünü döndürür.

yöntemler

İsimTanım
override Accept(DocumentVisitor)Bir ziyaretçiyi kabul eder.
Clone(bool)Düğümün bir kopyasını oluşturur.
GetAncestor(NodeType)Belirtilenin ilk atasını alırNodeType .
GetAncestor(Type)Belirtilen nesne türünün ilk atasını alır.
override GetText()Bu düğümün temsil ettiği özel karakteri alır.
NextPreOrder(Node)Ön sipariş ağacı geçiş algoritmasına göre bir sonraki düğümü alır.
PreviousPreOrder(Node)Ön sipariş ağacı geçiş algoritmasına göre önceki düğümü alır.
Remove()Kendini ana öğeden kaldırır.
RemoveField()Sadece form alanı özel karakterini değil, tüm form alanını kaldırır.
SetTextInputValue(object)Belirtilen metin biçimini uygularTextInputFormat ve değeri depolarResult .
ToString(SaveFormat)Düğümün içeriğini belirtilen biçimde bir dizeye aktarır.
ToString(SaveOptions)Belirtilen kaydetme seçeneklerini kullanarak düğümün içeriğini bir dizeye aktarır.

Notlar

Microsoft Word aşağıdaki form alanlarını sağlar: onay kutusu, metin girişi ve açılır liste (combobox).

FormField bir satır içi düğümdür ve yalnızca bir çocuğu olabilirParagraph.

FormField Bir belgede özel bir karakterle temsil edilir ve bir metin satırı içerisinde bir karakter olarak konumlandırılır.

Word belgesindeki tam bir form alanı, birkaç düğümle temsil edilen karmaşık bir yapıdır: alan başlangıcı, FORMTEXT gibi alan kodu, form alanı verileri, alan ayırıcı, alan sonucu, alan sonu ve bir yer imi. Word belgesinde programatik olarak form alanları oluşturmak için kullanınInsertCheckBox , InsertTextInput ve InsertComboBoxwhich tüm form alanı düğümlerinin doğru sırada ve uygun bir durumda oluşturulduğundan emin olun.

Örnekler

Alan değeri dahil olmak üzere tüm FormField’ın nasıl biçimlendirileceğini gösterir.

Document doc = new Document(MyDir + "Form fields.docx");

FormField formField = doc.Range.FormFields[0];
formField.Font.Bold = true;
formField.Font.Size = 24;
formField.Font.Color = Color.Red;

formField.Result = "Aspose.FormField";

doc = DocumentHelper.SaveOpen(doc);

Run formFieldRun = doc.FirstSection.Body.FirstParagraph.Runs[1];

Assert.AreEqual("Aspose.FormField", formFieldRun.Text);
Assert.AreEqual(true, formFieldRun.Font.Bold);
Assert.AreEqual(24, formFieldRun.Font.Size);
Assert.AreEqual(Color.Red.ToArgb(), formFieldRun.Font.Color.ToArgb());

Bir açılır kutunun nasıl ekleneceğini gösterir.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Please select a fruit: ");

// Kullanıcının bir dizi dize arasından bir seçenek seçmesine izin verecek bir açılır kutu ekleyin.
FormField comboBox = builder.InsertComboBox("MyComboBox", new[] { "Apple", "Banana", "Cherry" }, 0);

Assert.AreEqual("MyComboBox", comboBox.Name);
Assert.AreEqual(FieldType.FieldFormDropDown, comboBox.Type);
Assert.AreEqual("Apple", comboBox.Result);

// Form alanı "select" html etiketi biçiminde görünecektir.
doc.Save(ArtifactsDir + "FormFields.Create.html");

Ayrıca bakınız

FieldXE Class FormFieldCollection Class