File: LinkLabelTests.cs
Web Access
Project: src\src\System.Windows.Forms\tests\UnitTests\System.Windows.Forms.Tests.csproj (System.Windows.Forms.Tests)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
#nullable enable
 
using System.Drawing;
 
namespace System.Windows.Forms.Tests;
 
public class LinkLabelTests : IDisposable
{
    private readonly LinkLabel _linkLabel = new();
 
    public void Dispose() => _linkLabel.Dispose();
 
    [WinFormsFact]
    public void LinkLabel_Constructor()
    {
        _linkLabel.Should().NotBeNull();
        _linkLabel.LinkArea.IsEmpty.Should().BeTrue();
        _linkLabel.LinkArea.Start.Should().Be(0);
        _linkLabel.LinkArea.Length.Should().Be(0);
    }
 
    [WinFormsFact]
    public void LinkLabel_FlatStyle_Get_ReturnsExpected()
    {
        _linkLabel.FlatStyle.Should().Be(FlatStyle.Standard);
    }
 
    [WinFormsTheory]
    [InlineData(FlatStyle.Flat)]
    [InlineData(FlatStyle.Popup)]
    [InlineData(FlatStyle.System)]
    public void LinkLabel_FlatStyle_Set_ReturnsExpected(FlatStyle flatStyle)
    {
        _linkLabel.FlatStyle = flatStyle;
 
        _linkLabel.FlatStyle.Should().Be(flatStyle);
    }
 
    [WinFormsFact]
    public void LinkLabel_LinkArea_Get_ReturnsExpected()
    {
        _linkLabel.LinkArea.Should().Be(new LinkArea(0, 0));
    }
 
    [WinFormsFact]
    public void LinkLabel_LinkArea_Set_ReturnsExpected()
    {
        LinkArea linkArea1 = new LinkArea(1, 2);
        LinkArea linkArea2 = new LinkArea(3, 4);
 
        _linkLabel.LinkArea = linkArea1;
        _linkLabel.LinkArea.Should().Be(linkArea1);
 
        _linkLabel.LinkArea = linkArea2;
        _linkLabel.LinkArea.Should().Be(linkArea2);
    }
 
    [WinFormsTheory]
    [InlineData(-1, 2)]  // Test with negative Start
    [InlineData(1, -2)]  // Test with negative Length
    public void LinkLabel_LinkArea_Set_InvalidValues_ThrowsArgumentOutOfRangeException(int start, int length)
    {
        Action act = () => _linkLabel.LinkArea = new LinkArea(start, length);
        act.Should().Throw<ArgumentOutOfRangeException>().WithMessage("*LinkArea*");
    }
 
    [WinFormsFact]
    public void LinkLabel_LinkArea_Set_UpdatesSelectability()
    {
        _linkLabel.Text = "Text";
        _linkLabel.LinkArea = new LinkArea(1, 2);
        _linkLabel.TabStop.Should().BeTrue();
 
        _linkLabel.LinkArea = new LinkArea(0, 0);
        _linkLabel.TabStop.Should().BeFalse();
    }
 
    [WinFormsFact]
    public void LinkLabel_LinkBehavior_Get_ReturnsExpected()
    {
        _linkLabel.LinkBehavior.Should().Be(LinkBehavior.SystemDefault);
    }
 
    [WinFormsTheory]
    [InlineData(LinkBehavior.AlwaysUnderline)]
    [InlineData(LinkBehavior.HoverUnderline)]
    [InlineData(LinkBehavior.NeverUnderline)]
    public void LinkLabel_LinkBehavior_Set_ReturnsExpected(LinkBehavior linkBehavior)
    {
        _linkLabel.LinkBehavior = linkBehavior;
        _linkLabel.LinkBehavior.Should().Be(linkBehavior);
    }
 
    [WinFormsFact]
    public void LinkLabel_LinkVisited_Get_ReturnsExpected()
    {
        _linkLabel.LinkVisited.Should().BeFalse();
    }
 
    [WinFormsTheory]
    [InlineData(true)]
    [InlineData(false)]
    public void LinkLabel_LinkVisited_Set_ReturnsExpected(bool expectedVisited)
    {
        _linkLabel.LinkVisited = expectedVisited;
        _linkLabel.LinkVisited.Should().Be(expectedVisited);
    }
 
    [WinFormsFact]
    public void LinkLabel_LinkVisited_Set_AddsLinkIfNoneExists()
    {
        _linkLabel.LinkVisited = true;
        _linkLabel.Links.Count.Should().Be(1);
        _linkLabel.Links[0].Visited.Should().BeTrue();
    }
 
    [WinFormsFact]
    public void LinkLabel_LinkVisited_Set_UpdatesExistingLink()
    {
        _linkLabel.Links.Add(new LinkLabel.Link(_linkLabel) { Visited = false });
        _linkLabel.LinkVisited = true;
        _linkLabel.Links[0].Visited.Should().BeTrue();
 
        _linkLabel.LinkVisited = false;
        _linkLabel.Links[0].Visited.Should().BeFalse();
    }
 
    [WinFormsFact]
    public void LinkLabel_TabStop_Get_ReturnsExpected()
    {
        _linkLabel.TabStop.Should().BeFalse();
    }
 
    [WinFormsTheory]
    [InlineData(true)]
    [InlineData(false)]
    public void LinkLabel_TabStop_Set_ReturnsExpected(bool expectedTabStop)
    {
        _linkLabel.TabStop = expectedTabStop;
        _linkLabel.TabStop.Should().Be(expectedTabStop);
    }
 
    [WinFormsFact]
    public void LinkLabel_TabStop_Set_RaisesTabStopChangedEvent()
    {
        bool eventRaised = false;
        _linkLabel.TabStopChanged += (sender, e) => eventRaised = true;
 
        _linkLabel.TabStop = true;
        eventRaised.Should().BeTrue();
 
        eventRaised = false;
        _linkLabel.TabStop = false;
        eventRaised.Should().BeTrue();
    }
 
    [WinFormsFact]
    public void LinkLabel_Padding_Get_ReturnsExpected()
    {
        _linkLabel.Padding.Should().Be(new Padding(0));
    }
 
    [WinFormsFact]
    public void LinkLabel_Padding_Set_ReturnsExpected()
    {
        Padding padding1 = new(1, 2, 3, 4);
        Padding padding2 = new(5);
 
        _linkLabel.Padding = padding1;
        _linkLabel.Padding.Should().Be(padding1);
 
        _linkLabel.Padding = padding2;
        _linkLabel.Padding.Should().Be(padding2);
    }
 
    [WinFormsFact]
    public void LinkLabel_VisitedLinkColor_Get_ReturnsExpected()
    {
        _linkLabel.VisitedLinkColor.Should().Be(LinkUtilities.GetVisitedLinkColor());
    }
 
    [WinFormsFact]
    public void LinkLabel_VisitedLinkColor_Set_ReturnsExpected()
    {
        _linkLabel.VisitedLinkColor = Color.Red;
        _linkLabel.VisitedLinkColor.Should().Be(Color.Red);
 
        _linkLabel.VisitedLinkColor = Color.Blue;
        _linkLabel.VisitedLinkColor.Should().Be(Color.Blue);
    }
 
    [WinFormsFact]
    public void LinkLabel_VisitedLinkColor_Set_UpdatesLink()
    {
        _linkLabel.Links.Add(new LinkLabel.Link(_linkLabel) { Visited = true });
        _linkLabel.VisitedLinkColor = Color.Red;
        _linkLabel.VisitedLinkColor.Should().Be(Color.Red);
    }
 
    [WinFormsFact]
    public void LinkLabel_LinkClicked_RaisesEvent()
    {
        using TestLinkLabel label = new();
        bool eventRaised = false;
        label.LinkClicked += (sender, e) => eventRaised = true;
 
        var link = new LinkLabel.Link(label);
        label.Links.Add(link);
        label.OnLinkClicked(new LinkLabelLinkClickedEventArgs(link));
 
        eventRaised.Should().BeTrue();
    }
 
    [WinFormsFact]
    public void LinkLabel_UseCompatibleTextRendering_Get_ReturnsExpected()
    {
        _linkLabel.UseCompatibleTextRendering.Should().BeTrue();
    }
 
    [WinFormsTheory]
    [InlineData(true)]
    [InlineData(false)]
    public void LinkLabel_UseCompatibleTextRendering_Set_ReturnsExpected(bool expectedValue)
    {
        _linkLabel.UseCompatibleTextRendering = expectedValue;
        _linkLabel.UseCompatibleTextRendering.Should().Be(expectedValue);
    }
 
    [WinFormsFact]
    public void LinkLabel_UseCompatibleTextRendering_Set_TriggersLayout()
    {
        bool layoutCalled = false;
        _linkLabel.Layout += (sender, e) => layoutCalled = true;
 
        _linkLabel.UseCompatibleTextRendering = true;
        _linkLabel.PerformLayout();
        layoutCalled.Should().BeTrue();
 
        layoutCalled = false;
        _linkLabel.UseCompatibleTextRendering = false;
        _linkLabel.PerformLayout();
        layoutCalled.Should().BeTrue();
    }
 
    private class TestLinkLabel : LinkLabel
    {
        public new void OnLinkClicked(LinkLabelLinkClickedEventArgs e) => base.OnLinkClicked(e);
    }
}