FormField

FormField class

Tek bir form alanını temsil eder.

Daha fazlasını öğrenmek için şu adresi ziyaret edin:Form Alanlarıyla Çalışmak dokümantasyon makalesi.

public class FormField : SpecialChar

Özellikleri

İsimTanım
CalculateOnExit { get; set; }Belirtilen form alanına yapılan referanslar alandan her çıkıldığında otomatik olarak güncelleniyorsa doğrudur.
CheckBoxSize { get; set; }Onay kutusunun boyutunu nokta cinsinden alır veya ayarlar. Yalnızca şu durumlarda etkili olur:IsCheckBoxExactSize dır-dirdoğru .
Checked { get; set; }Onay kutusu form alanının işaretli durumunu alır veya ayarlar. Bu özelliğin varsayılan değeri:YANLIŞ .
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 özelliğin varsayılan değeri:YANLIŞ .
virtual Document { get; }Bu düğümün ait olduğu belgeyi alır.
DropDownItems { get; }Açılır form alanının öğelerine erişim sağlar.
DropDownSelectedIndex { get; set; }Açılır form alanında o anda seçili öğeyi belirten dizini alır veya ayarlar.
Enabled { get; set; }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 formatlamasına erişim sağlar.
HelpText { get; set; }Odak form alanı olduğunda ve kullanıcı F1. tuşuna bastığında mesaj 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; }İadelerdoğru bu düğüm başka düğümler içeriyorsa.
IsDeleteRevision { get; }Değişiklik izleme etkinken bu nesne Microsoft Word’de silinmişse true değerini döndürür.
IsFormatRevision { get; }Microsoft Word’de değişiklik izleme etkinken nesnenin biçimlendirmesi değiştirilmişse doğru değerini döndürür.
IsInsertRevision { get; }Bu nesne Microsoft Word’e değişiklik izleme etkinken eklenmişse doğru değerini döndürür.
IsMoveFromRevision { get; }İadelerdoğru değişiklik izleme etkinken bu nesne Microsoft Word’de taşındıysa (silindiyse).
IsMoveToRevision { get; }İadelerdoğru bu nesne Microsoft Word’de değişiklik izleme etkinken taşınmışsa (eklenmişse).
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üğümden hemen sonra gelen düğümü alır.
override NodeType { get; }İadelerFormField .
OwnHelp { get; set; }Odak bir form alanına geldiğinde ve kullanıcı F1. tuşuna bastığında mesaj kutusunda görüntülenen metnin kaynağını belirtir.
OwnStatus { get; set; }Odak noktası bir form alanı olduğunda durum çubuğunda görüntülenen metnin kaynağını belirtir.
ParentNode { get; }Bu düğümün doğrudan ebeveynini 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; }Bir değeri döndürürRange Bu 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; }Odak noktası bir form alanı olduğunda durum çubuğunda görüntülenen metni döndürür veya ayarlar.
TextInputDefault { get; set; }Bir metin formu alanının varsayılan dizesini veya hesaplama ifadesini alır veya ayarlar.
TextInputFormat { get; set; }Metin form alanı için metin formatını döndürür veya ayarlar.
TextInputType { get; set; }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)Ziyaretçi kabul eder.
Clone(bool)Düğümün bir kopyasını oluşturur.
GetAncestor(NodeType)Belirtilenin ilk atayı alırNodeType .
GetAncestor(Type)Belirtilen nesne türünün ilk atayı alır.
override GetText()Bu düğümün temsil ettiği özel karakteri alır.
NextPreOrder(Node)Ön sipariş ağaç geçiş algoritmasına göre sonraki düğümü alır.
PreviousPreOrder(Node)Ön sipariş ağaç geçiş algoritmasına göre önceki düğümü alır.
Remove()Kendini üst öğeden kaldırır.
RemoveField()Yalnızca form alanı özel karakterini değil, tüm form alanını kaldırır.
SetTextInputValue(object)Belirtilen metin biçimini uygular.TextInputFormat ve değeri içinde saklarResult .
ToString(SaveFormat)Düğümün içeriğini belirtilen formatta 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 menü (birleşik kutu).

FormFieldbir satır içi düğümdür ve yalnızca alt öğesi olabilirParagraph.

FormField bir belgede özel bir karakterle temsil edilir ve , metin satırındaki bir karakter olarak konumlandırılır.

Bir Word belgesindeki tam 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 yer işareti. Bir Word belgesinde programlı olarak form alanları oluşturmak için use InsertCheckBox , InsertTextInput ve InsertComboBox that tüm form alanı düğümlerinin doğru sırada ve uygun durumda oluşturulduğundan emin olun.

Örnekler

Alan değeri de dahil olmak üzere FormField’ın tamamını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());

Açılan 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 dizeden bir seçenek seçmesine olanak tanıyacak bir açılan 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 şeklinde görünecektir.
doc.Save(ArtifactsDir + "FormFields.Create.html");

Ayrıca bakınız