Nouveaux contrôles de contenu pour Telerik UI pour WPF RichTextBox

Avec les dernières améliorations de notre RichTextBox pour WPF, vous pouvez ajouter une sémantique spécifique telle que restreindre la saisie, modifier le comportement d'édition, etc. dans un document.

Avec la version R2 2020, Telerik UI for WPF a obtenu des contrôles de contenu pour RichTextBox qui permettent aux utilisateurs finaux d'ajouter facilement des sémantiques spécifiques telles que la restriction d'entrée, la modification du comportement d'édition, etc. à des parties d'un document donné. Dans cet article de blog, nous vous expliquerons les caractéristiques et fonctionnalités des contrôles de contenu.

Balises de document structurées et contrôles de contenu

Tout d'abord, clarifions une distinction importante entre les balises de document structuré et les contrôles de contenu. Les balises de document structurées sont des éléments XML (balises) définis dans WordprocessingML qui permettent d'incorporer la sémantique définie par le client ainsi que leur comportement et leur apparence dans un document. La représentation visuelle (UI) de ces éléments que nous appelons contrôles de contenu. Les balises de document structuré ont un contenu et des propriétés prédéfinies, et ces propriétés définissent les spécificités sémantiques, et selon elles, le RadRichTextBox décide quel contrôle de contenu afficher.

Pour une meilleure compréhension : Considérez une région qui doit être balisée avec la sémantique de «anniversaire», pour que l'utilisateur saisisse sa date de naissance dans le document. Idéalement, cette région utiliserait également un sélecteur de date pour permettre à l'utilisateur d'entrer la date à partir d'un calendrier:

Ce contenu serait spécifié en utilisant les propriétés des balises de document structurées et visualisé (en fonction de ces propriétés) en tant que contrôles de contenu dans le document.

Que sont les contrôles de contenu?

Les contrôles de contenu sont des contrôles individuels qui peuvent être utilisés à l'intérieur de formulaires, modèles et documents afin d'améliorer encore l'expérience utilisateur. Ils permettent aux utilisateurs de restreindre la saisie, de modifier le comportement d'édition, etc. Les contrôles de contenu peuvent être définis au niveau du bloc, en ligne, ligne ou cellule, et peuvent être imbriqués les uns dans les autres. Vous pouvez manipuler des contrôles de contenu existants ou en insérer de nouveaux.

Quand et pourquoi nous avons besoin de contrôles de contenu

Les contrôles de contenu fournissent un moyen de concevoir des documents et des modèles en:

• Contrôlant l'entrée depuis l'interface utilisateur.
  Par exemple , si vous avez besoin que l'utilisateur choisisse parmi une liste de choix dans une section de document, vous pouvez ajouter un contrôle de contenu Liste déroulante au document avec les options prédéfinies.
  
• Empêcher les utilisateurs de modifier les zones protégées.
  Les contrôles de contenu offrent la possibilité de restreindre la zone à l'intérieur du contrôle de contenu en utilisant ses propriétés de verrouillage, que vous pouvez voir plus loin dans la section Mécanique fine . Si la zone n'est pas à l'intérieur du contrôle de contenu ou si vous souhaitez restreindre une zone pouvant accueillir des contrôles de contenu et d'autres types de contenu, vous pouvez mettre l'ensemble zone dans un groupe contrôle de contenu ou i na Rich Text contrôle de contenu et définition de ses propriétés de verrouillage.

Utilisation des contrôles de contenu

Lorsque le contrôle RadRichTextBox est ouvert, vous pouvez choisir parmi les types de contrôle de contenu pris en charge dans l'onglet Développeur. [19659018] Picture03.png "title =" Picture03.png "/>

Types de contrôles de contenu pris en charge

Depuis R2 2020 il existe huit types de contrôle de contenu qui peuvent être insérés à l'aide du interface utilisateur (UI) ou l'API RadRichTextBox :

• Contrôle de contenu RTF : Ce contrôle de contenu représente un bloc de texte enrichi, où vous pouvez contenir du texte formaté ou d'autres éléments (par exemple images, tableaux ou même d'autres contrôles de contenu). C'est le contrôle de contenu le moins restrictif et peut contenir plus ou moins n'importe quoi.
• Texte brut contrôle de contenu: il représente un bloc de texte brut. Son contenu ne peut être composé que d'un seul paragraphe ou d'une seule cellule de tableau.
• Image contrôle de contenu: il peut être utilisé à l'intérieur de modèles. Il ajoute un espace réservé d'image qui peut être modifié ultérieurement pour contenir une image dans un modèle.
• Contrôle de contenu de la section extensible : Il contient au moins un paragraphe entier de texte ( Élément de section extensible ) qui peut être répété plusieurs fois.
• Case à cocher contrôle de contenu: Le contrôle de contenu peut être utilisé pour représenter un choix binaire. Les valeurs par défaut sont «cochées» et «non cochées», mais elles peuvent contenir n'importe quelle paire de symboles définis dans n'importe quelle police installée sur la machine actuelle.
• Combo Box contrôle de contenu: dans une zone de liste déroulante, vous pouvez sélectionner un élément d'une liste de choix, ou vous pouvez fournir votre propre texte personnalisé.
• Liste déroulante contrôle du contenu: contrairement à la zone de liste déroulante, le contenu d'une liste déroulante doit être l'un des paramètres prédéfinis
• Sélecteur de date contrôle de contenu: il peut être utilisé dans un modèle ou un formulaire pour indiquer qu'une date valide doit être entrée.

RadRichTextBox prend en charge l'importation / exportation et les opérations de base pour le contenu suivant contrôle également en utilisant son API :

• Groupe contrôle de contenu
• Citation contrôle de contenu
• Bibliographie contrôle de contenu
• Partie de document contrôle de contenu
• Document Part Gallery contrôle du contenu
• Equation c ontent control
• Article de section répétitive control de contenu

Fine Mechanics

Les contrôles de contenu exposent un tas de propriétés qui peuvent être modifiées à la fois directement depuis l'interface utilisateur ou par programme.

• Cet exemple montre comment utiliser le RadRichTextBox UI à Verrouiller (interdire la modification et la suppression) le contrôle de contenu Image et comment changer le format de la langue et et DateFormat de la Date Sélecteur Contrôle du contenu:
  
• Cet exemple illustre les fonctionnalités de PictureP new PictureProperties ();
  pictureProperties.Lock = Lock.SdtContentLocked;
  this.radRichTextBox.InsertSdt (pictureProperties);

  this.radRichTextBox.InsertLineBreak (); [19659044] DateProperties dateProperties = new DateProperties ();
  dateProperties.Language = new CultureInfo ("bg-BG");
  dateProperties.DateFormat = "dd MMMM yyyy 'г.'";
  dateProperties.FullDate = nouveau DateTime (2020, 5, 13);
  this.radRichTextBox.InsertSdt (dateProperties);

Essayez vous-même les contrôles de contenu

Procurez-vous un essai gratuit de Telerik UI pour WPF aujourd'hui et commencez à développer vos applications mieux, plus rapidement et plus facilement.

Découvrez Telerik UI pour WPF

Partagez votre Commentaires

Continuons à construire ensemble l'avenir de Telerik UI pour WPF! Alors n'oubliez pas de partager vos pensées sous forme de commentaire ci-dessous ou faites-nous savoir si vous avez des suggestions et / ou avez besoin de fonctionnalités / contrôles en visitant nos portails de commentaires sur l'interface utilisateur pour WPF / Silverlight et Bibliothèques de traitement de documents .