Les dernières fonctionnalités de Telerik Words

RichText

Peut contenir du texte formaté personnalisé ou d'autres éléments de document, tels que des tableaux, des images ou même d'autres contrôles de contenu.

Texte

Ce contrôle de contenu est limité au texte brut qui peut être sur plusieurs lignes. Il ne peut pas contenir d'éléments autres que du texte.

Image

Peut contenir une seule image qui peut être insérée par l'utilisateur.

ComboBox

Permet à l'utilisateur de sélectionner dans une liste de valeurs ou d'entrer une autre valeur.

DropDownList

Une liste de valeurs parmi lesquelles l'utilisateur peut sélectionner. Les valeurs différentes de celles spécifiées dans la liste ne sont pas autorisées.

CheckBox

Conserve et affiche un état activé / désactivé.

Date

Permet aux utilisateurs de sélectionner une date. Lorsqu'il est visualisé, un calendrier est utilisé pour faciliter la sélection.

RepeatingSection

La section extensible représente un ensemble d'éléments enfants (contrôles de contenu de texte enrichi) qui peuvent être facilement dupliqués, créant de nouveaux éléments qui en sont des copies. [19659024] Les autres types pris en charge dans WordsProcessing sont également RepeatingSectionItem, Bibliography, Citation, DocumentPart, DocumentPartGallery, Equation et Group.

Création d'un document contenant un contrôle de contenu en texte enrichi

Commençons à concevoir. Tout d'abord, je vais vous montrer comment insérer l'un des contrôles les plus fréquemment utilisés – CheckBox, dans votre document. La méthode InsertStructuredDocumentTag de RadFlowDocumentEditor peut être utilisée pour insérer tout type de contrôle de contenu. La méthode comporte plusieurs surcharges qui vous permettent de spécifier le type, les propriétés et les éléments de document relatifs du contrôle.

 RadFlowDocument document =  new   RadFlowDocument ();  
   RadFlowDocumentEditor editor =  new   RadFlowDocumentEditor (document);  
   var checkbox = editor.InsertStructuredDocumentTag (SdtType.CheckBox); 

La méthode InsertStructuredD contentocumentTag crée le marqueur d'annotation InsertStructuredD contentocumentTag contrôle et non le contenu lui-même (la case à cocher). Cela vous permet de personnaliser le formulaire à remplir après l'avoir inséré. Une fois le contrôle inséré, vous pouvez générer son contenu, comme ceci:

 CheckBoxProperties checkBoxProperties = checkbox.SdtProperties  as   CheckBoxProperties; 
 
   // Obtenir le courant état de la case à cocher  
   bool   isChecked = checkBoxProperties.Checked ==  null   || checkBoxProperties.Checked.Value;  
   SdtCheckBoxState activeState = isChecked? checkBoxProperties.CheckedState: checkBoxProperties.UncheckedState;  
  
   // Configurez le caractère utilisé pour la case à cocher et ses propriétés via l'objet Exécuter  [19659002]   Run run =  new   Run (document);  
   run.Properties.FontFamily.LocalValue =  new   ThemableFontFamily (activeState.Font);  
   char   c = ( char ) activeState.CharacterCode;  
   run .Text = c.ToString ();  
   run.Properties.CopyPropertiesFrom (checkBoxProperties.RunProperties);  
  
   // Insérez l'objet Run généré  
   Paragraph paragraph = checkbox.Paragraph;  
   int   index = paragraph.Inlines.IndexOf ( chec kbox.End);  
   paragraph.Inlines.Insert (index, run); 

Personnaliser le comportement et l'apparence des contrôles de contenu

Les contrôles de contenu exposent différentes propriétés qui vous permettent de configurer la façon dont vous voulez qu'ils apparaissent et comment ils doivent se comporter lorsque quelqu'un modifie le document.

Configurer l'apparence et l'apparence prédéfinies

Les contrôles de contenu définissent différents moyens pour les applications de les visualiser. Vous pouvez choisir de rendre le contrôle plus facile à voir en l'enveloppant dans un cadre de sélection ou des balises, ou en le laissant interférer avec l'autre contenu.

 RadFlowDocument document =  nouveau   RadFlowDocument ();  
   RadFlowDocumentEditor editor =  new   RadFlowDocumentEditor (document);  
  
  
  Exécutez contentRun = editor.InsertText ( "Contrôle de contenu affiché avec un cadre de sélection" );  
  var textControl = editor.InsertStructuredDocumentTag (SdtType.Text, contentRun, contentRun); 
   textControl.SdtProperties.OutlineAppearance = OutlineAppearance.BoundingBoxes;  
   textControl.SdtProperties.OutlineColor = Colors.Green; 

Vous avez le contrôle sur un espace réservé aux couleurs. ainsi que. Les espaces réservés vous permettent d'insérer une description dans le contrôle de contenu qui sera visualisé lorsque ce dernier n'a pas de contenu. En utilisant cette description, vous pouvez guider les utilisateurs du document sur ce qu'ils doivent exactement remplir.

 RadFlowDocument document =  new   RadFlowDocument ();  
   RadFlowDocumentEditor editor =  new   RadFlowDocumentEditor (document);  
  var textControl = editor.InsertStructuredDocumentTag (SdtStructuredDocumentTag)   textControl.SdtProperties.Tag =  "EmailAddress" ;  
   textControl.SdtProperties.Placeholder =  new   Placeholder ()  
   { 
    ShowPlaceholder =  true   
    PlaceholderText =  "Adresse e-mail"   
  }; 

Comportement de la configuration

Lors de la création de modèles qui seront remplis ultérieurement, vous devrez généralement restreindre les modifications de parties spécifiques du document et les autoriser là où l'entrée utilisateur doit être ajoutée. En plus de la fonction de protection des documents, vous pouvez également spécifier différentes restrictions des contrôles de contenu. En utilisant les différentes propriétés, vous pouvez spécifier si les utilisateurs peuvent modifier et / ou supprimer un contrôle de contenu.

Vous pouvez également trouver utile de supprimer un contrôle de contenu une fois que les utilisateurs ont saisi leur contenu. Cela peut être fait automatiquement en définissant la propriété IsTemporary sur true.

Curieux d'en savoir plus?

Maintenant que vous savez ce que vous pouvez réaliser avec la nouvelle fonctionnalité de WordsProcessing, vous pourriez être curieux de savoir comment exactement vous pouvez l'implémenter dans votre application. En plus des rubriques de documentation nous avons également préparé un exemple montrant une assez grande partie des fonctionnalités et vous pouvez le trouver sur notre référentiel d'exemples GitHub: Content Controls SDK .

Essayez-le

Assurez-vous de télécharger et d'essayer la dernière version de Telerik Document Processing et explorez toutes les nouvelles fonctionnalités. Les clients peuvent obtenir les derniers éléments de leur compte ou vous pouvez commencer un essai gratuit dès aujourd'hui:

Télécharger l'essai gratuit

Nous aimerions savoir comment tout cela fonctionne pour vous, alors n'hésitez pas à nous faire part de vos commentaires en visitant notre Portail de commentaires ou en laissant un commentaire ci-dessous.