Jak dodac efekt cienia do tekstu w C# | IronWord

Jak dodać efekt cienia do tekstu w języku C

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

Dodaj efekty cieniowania do tekstu w C# używając IronWord, tworząc obiekt TextStyle z własnością ShadowEffect, następnie zastosuj wbudowane cienie takie jak OuterShadow1 lub dostosuj właściwości, takie jak rozmycie, odległość i kolor, dla profesjonalnego efektu głębi tekstu.

Efekt cienia na tekście to technika poprawy wizualnej stosowana w celu nadania głębi i wyróżnienia elementów tekstowych. Po zastosowaniu wprowadza ona zduplikowaną wersję tekstu umieszczoną za oryginałem, lekko przesuniętą, aby nadać jej wygląd cienia. Ten tekst dodatkowy, znany jako cień, można dostosować na kilka sposobów, aby uzyskać różne efekty wizualne.

Efekty cieniowania są szczególnie przydatne podczas tworzenia profesjonalnych dokumentów, prezentacji i raportów, w których tekst musi się wyróżniać. Podobnie jak w przypadku tworzenia pustych prezentacji w programie PowerPoint, IronWord umożliwia programowe wzbogacanie dokumentów WORD o zaawansowane efekty tekstowe. Biblioteka oferuje zarówno gotowe opcje cieniowania do szybkiego wdrożenia, jak i szerokie możliwości dostosowywania do indywidualnych wymagań brandingowych.

Szybki start: Dodaj gotowy efekt cienia w jednej linii

Oto jak wzbogacić tekst dokumentu WORDa o cień za pomocą IronWord — wystarczy jedna linijka, aby zdefiniować styl i cień, a następnie zapisać. Szybkie wdrożenie przy minimalnej konfiguracji. Przed wdrożeniem efektów cienia upewnij się, że klucze licencyjne zostały poprawnie skonfigurowane, aby uniknąć znaków wodnych w dokumentach produkcyjnych.

  1. Install IronWord with NuGet Package Manager

    PM > Install-Package IronWord
  2. Skopiuj i uruchom ten fragment kodu.

    using IronWord;
    using IronWord.Models;
    
    WordDocument doc = new WordDocument();
    TextStyle textStyle = new TextStyle();
    textStyle.TextEffect = new TextEffect() { ShadowEffect = Shadow.OuterShadow1 };
    Paragraph paragraph = new Paragraph();
    Run textRun = new Run(new TextContent("Shadow Text"));
    textRun.Style = textStyle;
    paragraph.AddChild(textRun);
    doc.AddParagraph(paragraph);
    doc.SaveAs("shadow.docx");
  3. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronWord w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer

Jak dodać efekt cienia do tekstu?

To apply a shadow effect, create a TextStyle and populate its TextEffect property with a ShadowEffect. Then create a Paragraph, followed by a Run containing TextContent. Assign the TextStyle to the Run (not the TextContent), then use AddChild to add the Run to the Paragraph. To odzwierciedla hierarchię dokumentu: Dokument → Akapit → Fragment tekstu → Zawartość tekstu.

Proces wdrażania przebiega według prostego schematu, który płynnie integruje się z istniejącymi procesami generowania dokumentów. Niezależnie od tego, czy tworzysz automatyczne raporty, generujesz certyfikaty, czy opracowujesz dokumentację firmową, efekty cieniowania nadają elementom tekstowym profesjonalny wygląd. Dla organizacji rozważających opcje licencyjne, efekty cieniowania IronWord są zawarte we wszystkich poziomach licencji, zapewniając spójną funkcjonalność w środowiskach programistycznych, testowych i produkcyjnych.

Jakie gotowe efekty cieni są dostępne?

IronWord dostarcza kilka wbudowanych predefiniowanych cieni, takich jak OuterShadow1 przez OuterShadow20, które oferują różne style wizualne. Te ustawienia wstępne zapewniają szybkie wdrożenie bez konieczności ręcznej konfiguracji. Każdy zestaw został starannie zaprojektowany, aby odpowiadał typowym przypadkom użycia w profesjonalnym tworzeniu dokumentów:

  • OuterShadow1-5: Subtelne cienie dla tekstu głównego i nagłówków
  • OuterShadow6-10: Cienie o średniej intensywności dla tytułów i elementów wyróżniających
  • OuterShadow11-15: Wyraziste cienie na stronach tytułowych i separatorach sekcji
  • OuterShadow16-20: Efekty specjalne do prezentacji i dokumentów kreatywnych

Aby być na bieżąco z nowymi dodatkami i ulepszeniami, regularnie sprawdzaj dziennik zmian. Zespół programistów nieustannie udoskonala te ustawienia wstępne w oparciu o opinie użytkowników i trendy branżowe.

Kiedy należy używać gotowych, a kiedy niestandardowych efektów cienia?

Użyj gotowych cieni do standardowego formatowania dokumentów i szybkiej implementacji. Wybierz cienie niestandardowe, jeśli potrzebujesz spełnić konkretne wymagania dotyczące wizerunku marki lub uzyskać unikalne efekty wizualne, których nie zapewniają ustawienia wstępne. Cienie z ustawień wstępnych sprawdzają się doskonale w sytuacjach, w których kluczowa jest spójność w wielu dokumentach, takich jak szablony firmowe lub standardowe raporty.

Niestandardowe cienie stają się nieocenione podczas pracy z wytycznymi dotyczącymi marki, które określają dokładne wartości kolorów, pozycjonowanie lub efekty rozmycia. Zespoły marketingowe często wymagają precyzyjnych specyfikacji cieniowania, aby zachować spójność wizualną we wszystkich materiałach. Dodatkowo niestandardowe cienie pozwalają na uzyskanie kreatywnych efektów, takich jak cienie wielowarstwowe lub cienie, które uzupełniają określone kolory tła.

Jaki jest podstawowy wzorzec implementacji?

Stwórz WordDocument, skonfiguruj TextStyle za pomocą ShadowEffect, zastosuj styl do swojego tekstu i zapisz dokument. Schemat pozostaje spójny niezależnie od tego, czy używane są ustawienia wstępne, czy konfiguracje niestandardowe.

:path=/static-assets/word/content-code-examples/how-to/text-effect-shadow-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()
{
    ShadowEffect = Shadow.OuterShadow1,
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Hello World"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

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

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

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .ShadowEffect = Shadow.OuterShadow1
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Hello World"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

' Export new Word document
doc.SaveAs("shadowEffect.docx")
$vbLabelText   $csharpLabel
Dokument WORD z wyświetlonym tekstem

Jak mogę dostosować właściwości efektu cienia?

Oprócz przypisania predefiniowanej wartości cienia, wszystkie właściwości efektu cienia można konfigurować. Daje to elastyczną możliwość dostosowania efektu cienia w dowolny sposób. Poniżej znajdują się właściwości i ich opisy.

Dla zespołów rozważających przedłużenie licencji lub aktualizację, niestandardowe efekty cieniowania pokazują zaangażowanie IronWord w dostarczanie funkcji edycji dokumentów na poziomie Enterprise. Szerokie możliwości dostosowania sprawiają, że inwestycja w IronWord będzie rosła wraz z potrzebami w zakresie przetwarzania dokumentów.

Które właściwości kontrolują pozycjonowanie cienia?

  • Wyrównanie: Pobiera lub ustawia wyrównanie cienia.
  • DirectionAngle: Pobiera lub ustawia kąt kierunku efektu cienia. Kąt nachylenia jest podany w stopniach.
  • DistanceFromText: Pobiera lub ustawia odległość efektu cienia od tekstu lub obiektu. Odległość jest podana w punktach (1/72 cala).

Te właściwości pozycjonowania współdziałają ze sobą, tworząc realistyczne efekty cieni. Właściwość Alignment określa punkt kotwiczenia cienia względem tekstu, podczas gdy DirectionAngle symuluje kierunek źródła światła. DistanceFromText kontroluje postrzeganą wysokość tekstu ponad powierzchnią strony. Skuteczne połączenie tych właściwości tworzy cienie, które wydają się pochodzić ze spójnych źródeł światła w całym dokumencie.

Jakie właściwości wpływają na wygląd cienia?

  • BlurRadius: Pobiera lub ustawia promień rozmycia efektu cienia. Promień rozmycia jest określony w punktach (1/72 cala).
  • SchemeColor: Pobiera lub ustawia kolor schematu efektu cienia.

Właściwości wyglądu mają bezpośredni wpływ na jakość wizualną cieni. BlurRadius tworzy miękkie lub twarde krawędzie cienia — niższe wartości dają ostre cienie odpowiednie do dokumentacji technicznej, podczas gdy wyższe wartości tworzą rozproszone cienie idealne do kreatywnych projektów. SchemeColor umożliwia dopasowanie cieni do palety kolorów dokumentu, utrzymując spójność wizualną wewnątrz treści.

Jak kontrolować skalowanie cieni i zniekształcenia?

  • HorizontalScalingFactor: Pobiera lub ustawia współczynnik skalowania poziomego efektu cienia.
  • HorizontalSkewAngle: Pobiera lub ustawia kąt pochylenia poziomego efektu cienia. Kąt nachylenia jest podawany w stopniach.
  • VerticalScalingFactor: Pobiera lub ustawia współczynnik skalowania pionowego efektu cienia.
  • VerticalSkewAngle: Pobiera lub ustawia kąt pochylenia pionowego efektu cienia. Kąt nachylenia jest podawany w stopniach.

Właściwości skalowania i przekrzywiania umożliwiają uzyskanie efektów perspektywicznych, które nadają tekstowi trójwymiarowość. HorizontalScalingFactor i VerticalScalingFactor rozciągają lub kompresują cień, tworząc efekty, które symulują różne kąty widzenia. Kąty pochylenia pozwalają tworzyć efekty cieni przypominające kursywę lub symulować cienie rzucane na pochyłe powierzchnie, dodając dokumentom wyrafinowaną głębię wizualną.

Jakie są typowe zakresy wartości właściwości?

BlurRadius zazwyczaj waha się od 0 do 10 punktów, DirectionAngle od 0 do 360 stopni, a czynniki skalujące używają wartości procentowych (100 = normalny rozmiar). DistanceFromText zazwyczaj najlepiej sprawdza się między 1 a 5 punktów dla subtelnych efektów.

Zrozumienie tych zakresów pomaga szybko osiągnąć profesjonalne wyniki. Dla dokumentów biznesowych, konserwatywne wartości (BlurRadius: 2-4, DistanceFromText: 1-2) utrzymują czytelność, jednocześnie dodając wizualnego zainteresowania. Aplikacje kreatywne mogą przekraczać te granice, tworząc dramatyczne efekty (BlurRadius: 8-10, DistanceFromText: 4-6) dla większego wpływu. Należy pamiętać, że możliwości drukarki i rozdzielczość ekranu wpływają na wygląd cieni, dlatego należy przetestować dokumenty przy użyciu wszystkich przewidywanych metod wydruku.

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

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

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    ShadowEffect = new Shadow()
    {
        Alignment = RectangleAlignmentValues.BottomLeft,
        BlurRadius = 5,
        DirectionAngle = 45,
        DistanceFromText = 3,
        HorizontalScalingFactor = 100,
        VerticalScalingFactor = 100,
        HorizontalSkewAngle = 0,
        SchemeColor = IronWord.Models.Color.Aqua,
        VerticalSkewAngle = 0,
    },
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Customized shadow"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

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

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

' Create and configure text style
Dim textStyle As New TextStyle()
textStyle.TextEffect = New TextEffect() With {
    .ShadowEffect = New Shadow() With {
        .Alignment = RectangleAlignmentValues.BottomLeft,
        .BlurRadius = 5,
        .DirectionAngle = 45,
        .DistanceFromText = 3,
        .HorizontalScalingFactor = 100,
        .VerticalScalingFactor = 100,
        .HorizontalSkewAngle = 0,
        .SchemeColor = IronWord.Models.Color.Aqua,
        .VerticalSkewAngle = 0
    }
}

' Create paragraph
Dim paragraph As New Paragraph()

' Create run with text and style
Dim textRun As New Run(New TextContent("Customized shadow"))
textRun.Style = textStyle

' Add run to paragraph
paragraph.AddChild(textRun)

' Add paragraph to document
doc.AddParagraph(paragraph)

' Export new Word document
doc.SaveAs("customizedShadowEffect.docx")
$vbLabelText   $csharpLabel
Dostosowany efekt cienia

Często Zadawane Pytania

Jak dodać efekt cienia do tekstu w dokumentach Word w C#?

Aby dodać efekt cienia, używając IronWord, utwórz obiekt TextStyle i wypełnij jego właściwość ShadowEffect obiektem Shadow. Możesz użyć wstępnie ustawionych cieni, takich jak OuterShadow1, lub dostosować właściwości takie jak rozmycie, odległość i kolor. Następnie zastosuj ten styl do swojego tekstu przy dodawaniu go do dokumentu.

Czy mogę szybko zastosować wstępnie ustawiony efekt cienia bez personalizacji?

Tak, IronWord oferuje wstępnie ustawione opcje cienia dla szybkiej implementacji. Możesz zastosować efekt cienia w zaledwie jednej linii kodu: new IronWord.WordDocument().AddText("Shadow!").Style = new IronWord.Models.TextStyle { TextEffect = new IronWord.Models.TextEffect { ShadowEffect = IronWord.Models.Shadow.OuterShadow1 } };

Jakie opcje personalizacji cieni są dostępne?

IronWord pozwala na personalizację różnych właściwości cienia, w tym ilości rozmycia, odległości od tekstu, koloru cienia oraz przesunięcia pozycjonowania. Umożliwia to tworzenie unikalnych efektów cienia, które spełniają wymogi marki poza opcjami wstępnymi.

Czy potrzebuję specjalnej licencji, aby używać efektów cienia?

Efekty cienia są zawarte we wszystkich poziomach licencji IronWord. Jednak musisz prawidłowo skonfigurować swoje klucze licencyjne, aby uniknąć znaków wodnych w dokumentach produkcyjnych przy implementacji efektów tekstu takich jak cienie.

Do czego przydatne są efekty cienia w dokumentach Word?

Efekty cienia w IronWord są szczególnie przydatne przy tworzeniu profesjonalnych dokumentów, prezentacji i raportów, gdzie tekst musi się wyróżniać. Dodają głębi i wizualnego wyróżnienia elementom tekstowym, co czyni je idealnymi dla zautomatyzowanych raportów, certyfikatów i dokumentów z marką.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 38,043 | Wersja: 2026.4 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronWord
uruchom próbkę zobacz, jak twoje dane stają się dokumentem Word.