FormField
Contenido
[
Ocultar
]FormField class
Representa un único campo de formulario.
Para obtener más información, visite elTrabajar con campos de formulario artículo de documentación.
public class FormField : SpecialChar
Propiedades
| Nombre | Descripción |
|---|---|
| CalculateOnExit { get; set; } | Verdadero si las referencias al campo de formulario especificado se actualizan automáticamente cada vez que se sale del campo. |
| CheckBoxSize { get; set; } | Obtiene o establece el tamaño de la casilla de verificación en puntos. Tiene efecto sólo cuandoIsCheckBoxExactSize esverdadero . |
| Checked { get; set; } | Obtiene o establece el estado marcado del campo del formulario de casilla de verificación. El valor predeterminado para esta propiedad esFALSO . |
| CustomNodeId { get; set; } | Especifica el identificador de nodo personalizado. |
| Default { get; set; } | Obtiene o establece el valor predeterminado del campo del formulario de casilla de verificación. El valor predeterminado para esta propiedad esFALSO . |
| virtual Document { get; } | Obtiene el documento al que pertenece este nodo. |
| DropDownItems { get; } | Proporciona acceso a los elementos de un campo de formulario desplegable. |
| DropDownSelectedIndex { get; set; } | Obtiene o establece el índice que especifica el elemento seleccionado actualmente en un campo de formulario desplegable. |
| Enabled { get; set; } | Verdadero si un campo de formulario está habilitado. |
| EntryMacro { get; set; } | Devuelve o establece un nombre de macro de entrada para el campo del formulario. |
| ExitMacro { get; set; } | Devuelve o establece un nombre de macro de salida para el campo del formulario. |
| Font { get; } | Proporciona acceso al formato de fuente de este objeto. |
| HelpText { get; set; } | Devuelve o establece el texto que se muestra en un cuadro de mensaje cuando el campo del formulario tiene el foco y el usuario presiona F1. |
| IsCheckBoxExactSize { get; set; } | Obtiene o establece el valor booleano que indica si el tamaño del cuadro de texto es automático o se especifica explícitamente. |
| virtual IsComposite { get; } | Devolucionesverdadero si este nodo puede contener otros nodos. |
| IsDeleteRevision { get; } | Devuelve verdadero si este objeto se eliminó en Microsoft Word mientras el seguimiento de cambios estaba habilitado. |
| IsFormatRevision { get; } | Devuelve verdadero si se cambió el formato del objeto en Microsoft Word mientras el seguimiento de cambios estaba habilitado. |
| IsInsertRevision { get; } | Devuelve verdadero si este objeto se insertó en Microsoft Word mientras el seguimiento de cambios estaba habilitado. |
| IsMoveFromRevision { get; } | Devolucionesverdadero si este objeto se movió (eliminó) en Microsoft Word mientras el seguimiento de cambios estaba habilitado. |
| IsMoveToRevision { get; } | Devolucionesverdadero si este objeto se movió (insertó) en Microsoft Word mientras el seguimiento de cambios estaba habilitado. |
| MaxLength { get; set; } | Longitud máxima para el campo de texto. Cero cuando la longitud no está limitada. |
| Name { get; set; } | Obtiene o establece el nombre del campo del formulario. |
| NextSibling { get; } | Obtiene el nodo que sigue inmediatamente a este nodo. |
| override NodeType { get; } | DevolucionesFormField . |
| OwnHelp { get; set; } | Especifica el origen del texto que se muestra en un cuadro de mensaje cuando un campo de formulario tiene el foco y el usuario presiona F1. |
| OwnStatus { get; set; } | Especifica el origen del texto que se muestra en la barra de estado cuando un campo de formulario tiene el foco. |
| ParentNode { get; } | Obtiene el padre inmediato de este nodo. |
| ParentParagraph { get; } | Recupera el padreParagraph de este nodo. |
| PreviousSibling { get; } | Obtiene el nodo inmediatamente anterior a este nodo. |
| Range { get; } | Devuelve unRange objeto que representa la parte de un documento contenido en este nodo. |
| Result { get; set; } | Obtiene o establece una cadena que representa el resultado de este campo de formulario. |
| StatusText { get; set; } | Devuelve o establece el texto que se muestra en la barra de estado cuando un campo de formulario tiene el foco. |
| TextInputDefault { get; set; } | Obtiene o establece la cadena predeterminada o una expresión de cálculo de un campo de formulario de texto. |
| TextInputFormat { get; set; } | Devuelve o establece el formato de texto para un campo de formulario de texto. |
| TextInputType { get; set; } | Obtiene o establece el tipo de un campo de formulario de texto. |
| Type { get; } | Devuelve el tipo de campo del formulario. |
Métodos
| Nombre | Descripción |
|---|---|
| override Accept(DocumentVisitor) | Acepta un visitante. |
| Clone(bool) | Crea un duplicado del nodo. |
| GetAncestor(NodeType) | Obtiene el primer ancestro del especificadoNodeType . |
| GetAncestor(Type) | Obtiene el primer antepasado del tipo de objeto especificado. |
| override GetText() | Obtiene el carácter especial que representa este nodo. |
| NextPreOrder(Node) | Obtiene el siguiente nodo según el algoritmo transversal del árbol de pedidos anticipados. |
| PreviousPreOrder(Node) | Obtiene el nodo anterior según el algoritmo transversal del árbol de pedidos anticipados. |
| Remove() | Se elimina del padre. |
| RemoveField() | Elimina el campo completo del formulario, no solo el carácter especial del campo del formulario. |
| SetTextInputValue(object) | Aplica el formato de texto especificado enTextInputFormat y almacena el valor enResult . |
| ToString(SaveFormat) | Exporta el contenido del nodo a una cadena en el formato especificado. |
| ToString(SaveOptions) | Exporta el contenido del nodo a una cadena usando las opciones de guardado especificadas. |
Observaciones
Microsoft Word proporciona los siguientes campos de formulario: casilla de verificación, entrada de texto y menú desplegable (cuadro combinado).
FormFieldes un nodo en línea y sólo puede ser hijo deParagraph.
FormField se representa en un documento mediante un carácter especial y se posiciona como un carácter dentro de una línea de texto.
Un campo de formulario completo en un documento de Word es una estructura compleja representada por varios nodos : inicio del campo, código de campo como FORMTEXT, datos del campo del formulario, separador de campo, resultado del campo , final del campo y un marcador. Para crear campos de formulario mediante programación en un documento de Word use InsertCheckBox , InsertTextInput y InsertComboBox which asegúrese de que todos los nodos del campo del formulario se creen en el orden correcto y en un estado adecuado.
Ejemplos
Muestra cómo formatear todo el FormField, incluido el valor del campo.
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());
Muestra cómo insertar un cuadro combinado.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Please select a fruit: ");
// Inserta un cuadro combinado que permitirá al usuario elegir una opción de una colección de cadenas.
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);
// El campo del formulario aparecerá en forma de etiqueta html "seleccionada".
doc.Save(ArtifactsDir + "FormFields.Create.html");
Ver también
- class SpecialChar
- espacio de nombres Aspose.Words.Fields
- asamblea Aspose.Words
