کنترل LinkLable در سی شارپ

کنترل LinkLable در سی شارپ

کنترل LinkLabel در سی‌شارپ یکی از ابزارهای کاربردی در توسعه برنامه‌های ویندوزی است که امکان ایجاد متن‌های قابل کلیک را فراهم می‌کند.

برخلاف Label معمولی، این کنترل به کاربران اجازه می‌دهد با کلیک روی متن، عملیاتی مانند باز کردن وب‌سایت، اجرای برنامه یا پرش به بخش دیگری از فرم را انجام دهند.

LinkLabel به‌طور پیش‌فرض متن را با رنگ آبی و زیرخط‌دار نمایش می‌دهد و می‌توان ویژگی‌هایی مانند رنگ لینک بازدید شده، محدوده کلیک‌پذیر و رویدادهای مختلف را برای آن تعریف کرد.

برای استفاده از LinkLabel، کافیست آن را از جعبه ابزار به فرم اضافه کنید یا به‌صورت برنامه‌نویسی ایجاد نمایید.

با استفاده از رویداد LinkClicked می‌توانید عملیات مورد نظر را پیاده‌سازی کنید.

این کنترل از چندین لینک در یک متن پشتیبانی می‌کند و برای ایجاد منوهای تعاملی، راهنمای آنلاین یا پیوندهای سریع بسیار مناسب است.

با تنظیم ویژگی‌هایی مانند LinkArea می‌توانید بخش‌های خاصی از متن را به‌عنوان لینک فعال کنید و تجربه کاربری بهتری ایجاد نمایید.

کاربردهای اصلی LinkLabel

• پیوندهای خارجی

  اتصال به وب‌سایت‌ها و منابع اینترنتی

• اجرای برنامه‌ها

  راه‌اندازی نرم‌افزارهای دیگر

• پیمایش داخلی

  جابجایی بین بخش‌های مختلف برنامه

• راهنمای تعاملی

  نمایش کمک‌های متنی یا پنجره‌های راهنما

• منوهای پویا

  ایجاد ساختارهای ناوبری پیچیده

ویژگی‌های کلیدی کنترل LinkLable در سی شارپ

• ویژگی‌های مربوط به ظاهر

  • LinkColor: تعیین رنگ پیش‌فرض لینک‌ها (مقدار پیش‌فرض: آبی)
  • ActiveLinkColor: رنگ هنگام کلیک (مقدار پیش‌فرض: قرمز)
  • VisitedLinkColor: رنگ پس از بازدید (مقدار پیش‌فرض: بنفش)
  • DisabledLinkColor: رنگ در حالت غیرفعال
  • LinkBehavior: تعیین رفتار ظاهری (AlwaysUnderline, HoverUnderline, NeverUnderline, SystemDefault)

• ویژگی‌های محتوایی

  • Text: متن نمایش داده شده
  • LinkArea: محدوده متنی که به عنوان لینک عمل می‌کند
  • Links: مجموعه تمام لینک‌های موجود در کنترل
  • LinkVisited: وضعیت بازدید لینک

 رویدادهای مهم کنترل LinkLable در سی شارپ

• LinkClicked: هنگام کلیک روی لینک
• MouseEnter/MouseLeave: تشخیص حضور ماوس
• TextChanged: هنگام تغییر متن

 

آیا به دنبال یک فرصت عالی برای یادگیری برنامه‌نویسی هستید؟ 🚀

با دوره آموزشی سی‌شارپ ما، شما می‌توانید مهارت‌های خود را به سطح جدیدی ارتقا دهید! این دوره به‌طور کامل طراحی شده تا به شما کمک کند تا از مبتدی تا پیشرفته در دنیای برنامه‌نویسی سی‌شارپ پیش بروید.

👨‍🏫 چرا دوره ما را انتخاب کنید؟

• محتوای جامع و عملی: با پروژه‌های واقعی و تمرینات عملی، یادگیری را به تجربه‌ای جذاب تبدیل کنید.
• مدرس مجرب: از تجربه و دانش مدرس حرفه‌ای بهره‌مند شوید که شما را در هر مرحله از یادگیری راهنمایی می‌کنند.
• پشتیبانی ۲۴/۷: هر زمان که سوالی داشتید، ما در کنار شما خواهیم بود تا به شما کمک کنیم.
• دسترسی مادام‌العمر: به محتوای دوره دسترسی دائمی داشته باشید و هر زمان که خواستید، می‌توانید به آن مراجعه کنید.

💡 فرصت را از دست ندهید!

بایادگیری سی‌شارپ، می‌توانید در دنیای فناوری اطلاعات به یک متخصص تبدیل شوید و در پروژه‌های جذاب و چالش‌برانگیز شرکت کنید.

همین امروز به جمع یادگیرندگان ما بپیوندید و اولین قدم را به سوی آینده‌ای روشن‌تر بردارید!

شرکت در دوره آموزش برنامه نویسی سی شارپ

 

پیاده‌سازی پیشرفته با مثال‌های کاربردی

• ایجاد سیستم چندزبانه با LinkLabel

// ایجاد دیکشنری برای ترجمه
Dictionary<string, Dictionary<string, string>> translations = new()
{
    {"en", new Dictionary<string, string> 
        {{"welcome", "Welcome"}, {"change", "Change language"}}},
    {"fa", new Dictionary<string, string> 
        {{"welcome", "خوش آمدید"}, {"change", "تغییر زبان"}}}
};

LinkLabel languageLink = new()
{
    Text = translations[currentLang]["change"],
    Location = new Point(20, 50)
};

languageLink.LinkClicked += (sender, e) => 
{
    currentLang = (currentLang == "en") ? "fa" : "en";
    UpdateUI();
};

void UpdateUI()
{
    languageLink.Text = translations[currentLang]["change"];
    welcomeLabel.Text = translations[currentLang]["welcome"];
}

• ایجاد کنترل پیشرفته دانلود فایل

LinkLabel downloadLink = new()
{
    Text = "دانلود فایل (حجم: 25MB)",
    Tag = "http://example.com/file.zip"
};

downloadLink.LinkClicked += async (sender, e) => 
{
    var link = (LinkLabel)sender;
    string url = link.Tag.ToString();
    
    try
    {
        link.Enabled = false;
        link.Text = "در حال دانلود...";
        
        using (HttpClient client = new())
        {
            var response = await client.GetAsync(url);
            var fileName = Path.GetFileName(url);
            
            using (var fs = new FileStream(fileName, FileMode.Create))
            {
                await response.Content.CopyToAsync(fs);
            }
        }
        
        link.Text = "دانلود کامل شد!";
    }
    catch (Exception ex)
    {
        link.Text = "خطا در دانلود";
        MessageBox.Show(ex.Message);
    }
    finally
    {
        link.LinkVisited = true;
    }
};

الگوهای طراحی پیشرفته با LinkLabel

• پیاده‌سازی الگوی Observer

// رابط ناظر
public interface ILinkObserver
{
    void Update(string linkUrl);
}

// کلاس پایه برای LinkLabelهای مشاهده‌گر
public class ObservableLinkLabel : LinkLabel
{
    private List<ILinkObserver> _observers = new();
    
    public void AddObserver(ILinkObserver observer)
    {
        _observers.Add(observer);
    }
    
    protected override void OnLinkClicked(LinkLabelLinkClickedEventArgs e)
    {
        base.OnLinkClicked(e);
        
        foreach (var observer in _observers)
        {
            observer.Update(e.Link.LinkData?.ToString());
        }
    }
}

// استفاده در برنامه
var analyticsLink = new ObservableLinkLabel()
{
    Text = "مشاهده آمار",
    LinkData = "analytics:show"
};

analyticsLink.AddObserver(new AnalyticsTracker());

• پیاده‌سازی الگوی Decorator

public abstract class LinkLabelDecorator : LinkLabel
{
    protected LinkLabel _linkLabel;
    
    public LinkLabelDecorator(LinkLabel linkLabel)
    {
        _linkLabel = linkLabel;
        this.Text = _linkLabel.Text;
        this.Links.AddRange(_linkLabel.Links.Cast<Link>().ToArray());
        
        foreach (var handler in _linkLabel.GetInvocationList("LinkClicked"))
        {
            this.LinkClicked += (EventHandler<LinkLabelLinkClickedEventArgs>)handler;
        }
    }
}

public class TooltipLinkDecorator : LinkLabelDecorator
{
    private string _tooltip;
    
    public TooltipLinkDecorator(LinkLabel link, string tooltip) : base(link)
    {
        _tooltip = tooltip;
        this.MouseEnter += (s, e) => ShowTooltip();
        this.MouseLeave += (s, e) => HideTooltip();
    }
    
    private void ShowTooltip()
    {
        // نمایش Tooltip
    }
    
    private void HideTooltip()
    {
        // پنهان کردن Tooltip
    }
}

// استفاده در برنامه
var basicLink = new LinkLabel { Text = "کمک" };
var decoratedLink = new TooltipLinkDecorator(basicLink, "راهنمای استفاده از سیستم");

بهینه‌سازی و نکات حرفه‌ای کنترل LinkLable 

• مدیریت حافظه

  • همیشه رویدادها را هنگام حذف کنترل Unsubscribe کنید
  • از استفاده بیش از حد از LinkLabelهای پویا خودداری کنید
  • برای لینک‌های سنگین از بارگذاری تنبل (Lazy Loading) استفاده کنید

• امنیت

private void SafeLinkOpen(string url)
{
    if (!Uri.IsWellFormedUriString(url, UriKind.Absolute))
    {
        throw new ArgumentException("آدرس نامعتبر است");
    }
    
    var uri = new Uri(url);
    if (uri.Scheme != "http" && uri.Scheme != "https")
    {
        throw new SecurityException("پروتکل غیرمجاز");
    }
    
    Process.Start(new ProcessStartInfo
    {
        FileName = url,
        UseShellExecute = true
    });
}

• سفارشی‌سازی پیشرفته

public class CustomLinkLabel : LinkLabel
{
    protected override void OnPaint(PaintEventArgs e)
    {
        // رسم پیش‌زمینه سفارشی
        using (var brush = new SolidBrush(BackColor))
        {
            e.Graphics.FillRectangle(brush, ClientRectangle);
        }
        
        // رسم متن با سبک خاص
        TextRenderer.DrawText(e.Graphics, Text, Font, 
            ClientRectangle, LinkColor, TextFormatFlags.Left);
        
        // رسم حاشیه
        ControlPaint.DrawBorder(e.Graphics, ClientRectangle, 
            Color.Gray, ButtonBorderStyle.Dotted);
    }
}