Comment ajouter l'effet de réflexion au texte en C# | IronWord

Comment ajouter un effet de réflexion à du texte en C

This article was translated from English: Does it need improvement?
Translated
View the article in English

Appliquez un effet de réflexion de type miroir au texte en C# à l'aide de l'API simple d'IronWord. Créez des reflets de texte professionnels avec une seule ligne de code, simulant un texte reflété sur une surface pour une profondeur visuelle accrue.

Démarrage rapide : Appliquer un effet de réflexion au texte en C#

Avec une seule ligne de code utilisant IronWord, vous pouvez appliquer un effet de réflexion prédéfini à n'importe quel texte. Commencez immédiatement - aucune configuration complexe ou code standard n'est nécessaire.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronWord avec le gestionnaire de packages NuGet

    PM > Install-Package IronWord

  2. Copiez et exécutez cet extrait de code.

    new IronWord.WordDocument().AddText("Quick Text").Style = new IronWord.Models.TextStyle(){ TextEffect = new IronWord.Models.TextEffect(){ ReflectionEffect = new IronWord.Models.Reflection() } };
  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronWord dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer

Comment ajouter un effet de réflexion?

Pour spécifier l'effet de réflexion du texte, créez l'objet TextStyle et renseignez la propriété ReflectionEffect avec un objet Reflection . Enfin, ajoutez du nouveau texte avec le style en assignant l'objet TextStyle à la propriété TextEffect .

Les effets de réflexion améliorent la présentation du document en ajoutant de la profondeur et de l'intérêt visuel aux éléments de texte importants. Cet effet fonctionne particulièrement bien pour les en-têtes, les titres et la mise en valeur des informations clés dans les documents professionnels. Le reflet simule un texte posé sur une surface brillante, créant un aspect élégant et moderne qui attire l'attention du lecteur.

Pourquoi la création d'un TextStyle est-elle importante ?

L'objet TextStyle sert de point de configuration central pour toutes les mises en forme de texte dans IronWord. En séparant le style du contenu, vous pouvez réutiliser le même effet de réflexion sur plusieurs éléments de texte, ce qui garantit la cohérence de l'ensemble du document. Cette approche facilite également la mise à jour globale de l'effet de réflexion en modifiant un seul objet de style.

:path=/static-assets/word/content-code-examples/how-to/text-effect-reflection-effect.cs
using IronWord;
using IronWord.Models;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    ReflectionEffect = new Reflection(),
};

// Add text with style
doc.AddText("Hello World").Style = textStyle;

// Export new Word document
doc.SaveAs("reflectionEffect.docx");
Imports IronWord
Imports IronWord.Models

' Create new Word document
Private doc As New WordDocument()

' Create and configure text style
Private textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {.ReflectionEffect = New Reflection()}

' Add text with style
doc.AddText("Hello World").Style = textStyle

' Export new Word document
doc.SaveAs("reflectionEffect.docx")
$vbLabelText   $csharpLabel

À quoi ressemble la réflexion par défaut?

L'effet de réflexion par défaut crée une image miroir subtile sous le texte avec une réduction automatique de l'opacité. Cette configuration prédéfinie fonctionne bien pour la plupart des documents et présentations d'entreprise, sans nécessiter de personnalisation supplémentaire. Le reflet apparaît à une distance standard avec des paramètres de flou et de transparence appropriés qui complètent les différentes tailles et styles de police.

Microsoft Word montrant le texte 'Hello World' avec un effet de réflexion créant une copie semi-transparente en miroir en dessous

Quelles sont les propriétés que je peux configurer pour les effets de réflexion ? L'effet de réflexion offre une gamme d'attributs réglables pour répondre à diverses exigences de conception. La compréhension de ces propriétés vous permet de créer des effets visuels uniques adaptés à votre style de document spécifique. Chaque propriété contrôle un aspect différent du reflet, de sa position et de son angle à sa transparence et à sa couleur. Consultez la liste suivante pour obtenir une description détaillée de chaque propriété :

Quelles sont les propriétés qui contrôlent l'apparence de la réflexion ? - `SchemeColor` : Obtient ou définit la couleur du schéma de l'effet de réflexion. Teintez les reflets avec n'importe quelle couleur pour obtenir des effets d'eau ou de surface métallique. - `HorizontalSkewAngle` : Obtient ou définit l'angle d'inclinaison horizontale en degrés. Créez des effets de perspective où les reflets s'éloignent. - `HorizontalScalingFactor` : Obtient ou définit le facteur d'échelle horizontale. Les valeurs inférieures à 100 sont compressées ; les valeurs supérieures à 100 s'étirent. - `DistanceFromText` : Obtient ou définit la distance en points (1/72 pouce). Les petites valeurs créent des reflets serrés ; les valeurs plus élevées simulent des surfaces éloignées. - `DirectionAngle` : Obtient ou définit l'angle de direction en degrés. Détermine la direction apparente de la source lumineuse. - `FadeDirectionAngle` : Obtient ou définit la direction du fondu en degrés. Contrôlez l'évanouissement vertical pour les reflets du sol ou l'évanouissement angulaire pour les effets de l'eau. - `EndPosition` : Obtient ou définit la position finale. Détermine l'endroit où le reflet s'estompe complètement. - `StartPosition` : Obtient ou définit la position de départ. Typiquement 0 pour commencer immédiatement sous le texte. - `EndingOpacity` : Obtient ou définit l'opacité finale. Les valeurs inférieures créent des reflets subtils qui s'estompent jusqu'à la transparence. - `VerticalScalingFactor` : Obtient ou définit le facteur d'échelle verticale. Les valeurs négatives font basculer le texte ; la magnitude contrôle la hauteur. - `StartingOpacity` : Obtient ou définit l'opacité de départ. Des valeurs plus élevées créent des réflexions initiales plus fortes. - `Alignement` : Obtient ou définit l'alignement. Choisissez parmi différentes options pour positionner le reflet par rapport au texte. - `BlurRadius` : Obtient ou définit le rayon de flou en points (1/72 pouce). Les valeurs élevées créent des reflets plus doux et plus diffus. - `VerticalSkewAngle` : Obtient ou définit l'angle d'inclinaison verticale en degrés. À utiliser pour créer des effets de réflexion inclinés. ### Comment créer un effet de réflexion personnalisé? Les effets de reflet personnalisés vous permettent de respecter l'image de marque de votre organisation ou de créer des styles visuels uniques. L'exemple suivant présente un reflet teinté d'or avec des paramètres de positionnement et d'opacité spécifiques qui créent un aspect professionnel pour les certificats, les récompenses ou les en-têtes de documents de qualité supérieure. ```csharp :path=/static-assets/word/content-code-examples/how-to/text-effect-customized-reflection-effect.cs ```

Quels résultats puis-je obtenir avec les propriétés personnalisées ? L'exemple de reflet personnalisé ci-dessus produit un reflet teinté d'or distinctif qui renforce l'aspect haut de gamme du document. En ajustant le gradient d'opacité de 0 % à 100 %, le reflet crée un effet de fondu inversé où le reflet devient plus fort au fur et à mesure qu'il s'éloigne du texte. Cette technique fonctionne bien pour créer des en-têtes proéminents ou pour mettre en évidence des annonces importantes.
Document Word montrant le texte 'Reflet personnalisé' avec l'effet de reflet gris appliqué
### Bonnes pratiques pour les effets de réflexion Lorsque vous mettez en œuvre des effets de réflexion dans des documents professionnels, tenez compte des directives suivantes : : Pour les documents commerciaux, utilisez des valeurs d'opacité finales plus faibles (20-40 %) pour créer des reflets subtils qui mettent en valeur sans distraire. Réservez les effets plus prononcés aux documents marketing ou aux présentations où l'impact visuel est primordial. : Alignez les propriétés de réflexion sur la conception générale de votre document. Les documents formels bénéficient de simples reflets verticaux avec un minimum de flou, tandis que les documents créatifs peuvent utiliser des angles obliques et des reflets colorés pour un effet artistique. **Considérations relatives aux performances** : Les effets de réflexion complexes avec des valeurs de rayon de flou élevées peuvent augmenter la taille des fichiers et le temps de traitement. Pour les documents comportant de nombreux éléments réfléchis, testez les performances et ajustez les propriétés en conséquence. : N'oubliez pas que les effets décoratifs tels que les reflets doivent renforcer et non remplacer une communication claire. Veillez à ce que votre texte principal reste très lisible, en particulier lorsque vous créez des documents qui doivent répondre aux normes d'accessibilité.

Questions Fréquemment Posées

Comment ajouter un effet de réflexion à un texte en C# ?

Avec IronWord, vous pouvez ajouter un effet de réflexion en créant un objet TextStyle et en remplissant la propriété ReflectionEffect avec un objet Reflection. Il vous suffit d'instancier la classe Reflection et de l'affecter à votre style de texte - IronWord se charge automatiquement de tous les rendus complexes.

Quelle est la manière la plus simple d'appliquer un effet de réflexion de texte ?

La méthode la plus rapide consiste à utiliser l'implémentation en une ligne d'IronWord : new IronWord.WordDocument().AddText("Votre texte").Style = new IronWord.Models.TextStyle(){ TextEffect = new IronWord.Models.TextEffect(){ ReflectionEffect = new IronWord.Models.Reflection() } }. Cela permet d'appliquer instantanément un effet de réflexion par défaut.

Puis-je personnaliser les propriétés de l'effet de réflexion ?

Oui, la classe Reflection d'IronWord fournit diverses propriétés configurables pour ajuster l'apparence du reflet, notamment l'atténuation de l'opacité, la distance par rapport au texte, les paramètres de flou et les niveaux de transparence. Vous pouvez affiner ces attributs pour créer des effets visuels uniques adaptés à vos besoins de conception spécifiques.

À quoi ressemble l'effet de réflexion par défaut ?

Le reflet par défaut d'IronWord crée une image miroir subtile sous le texte avec un fondu d'opacité automatique. La configuration prédéfinie comprend des paramètres de flou et de transparence appropriés qui fonctionnent bien avec différentes tailles et styles de polices, ce qui permet de l'utiliser pour la plupart des documents commerciaux sans personnalisation supplémentaire.

Pourquoi devrais-je utiliser des objets TextStyle pour les effets de réflexion ?

Les objets TextStyle dans IronWord servent de point de configuration central pour tout le formatage du texte. Cette séparation du style et du contenu vous permet de réutiliser le même effet de réflexion sur plusieurs éléments de texte, ce qui garantit la cohérence et facilite la mise à jour globale des effets en modifiant un seul objet de style.

Quels sont les types de documents qui bénéficient des effets de réflexion ?

Les effets de réflexion fonctionnent particulièrement bien pour les en-têtes, les titres et la mise en valeur des informations clés dans les documents professionnels. La fonction de réflexion d'IronWord simule un texte posé sur une surface brillante, créant une apparence élégante qui améliore la présentation du document et attire l'attention du lecteur sur les éléments importants.

Curtis Chau
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 28,054 | Version : 2025.12 vient de sortir