Çalışsayfada Hiperbağlantıları Yönetme

Bu konu Aspose.Cells.GridWeb’de desteklenen bağlantı türlerini ve bunları programlı olarak nasıl yöneteceğinizi tartışmaktadır. Bağlantılar, web URL’lerine bağlantı oluşturmak veya sunucuya postback yapmak için kullanılabilir.

Hiperbağlantıyla Çalışma

Bağlantı Türleri

Genellikle, Aspose.Cells.GridWeb tarafından desteklenen aşağıdaki hiperbağlantılar:

• URL hiperbağlantıları, web URL’lerine bağlanabilen hiperbağlantılar.
• Metin hiperbağlantıları, metne uygulanan URL hiperbağlantıları.
• Görüntü hiperbağlantıları, görüntülere uygulanan URL hiperbağlantıları.
• Hücre işlemi hiperbağlantıları, sunucuya veri gönderen hiperbağlantılar. Bu tür hiperbağlantılar, tıklandığında sunucu taraflı bir etkinlik başlatan bir düğme gibi davranır.

Aşağıdaki bölümler, tüm hiperbağlantı türlerinin ayrıntılı kullanımını açıklar. Ayrıca bağlantılara erişme veya kaldırma konuları da tartışılır.

Hyperlinkler Ekleme

URL Hiperbağlantıları

URL hiperbağlantıları, genellikle web sitelerinde gördüğünüz basit bağlantılara daha çok benzer. Bir URL hiperbağlantısı, hücrede bir çapa gibi çalışır. Tıkladığınızda web sayfasına gitmek veya yeni bir tarayıcı penceresi açmak gibi işlev görür.

Farklı türde URL hiperbağlantıları bulunmaktadır:

• Metin hiperbağlantıları.
• Resim hiperbağlantıları.

Geliştiriciler, hiperbağlantı için bir resim belirleyebilirler. Eğer bir resim belirtilmemişse, bir metin hiperbağlantısı oluşturulur; aksi halde bir resim hiperbağlantısı oluşturulur.

Metin Hiperbağlantıları

Bir çalışma sayfasına metin hiperbağlantısı eklemek için:

1. Aspose.Cells.GridWeb denetimini Web Formunuza ekleyin.
2. Bir çalışsayı açın.
3. Bir hücreye bir hiperbağlantı ekleyin.
4. Hücrede gösterilecek metni ayarlayın.
5. Hiperbağlantının URL’sini ayarlayın.
6. Hiperbağlantının hedefini isteğe bağlı olarak ayarlayın.
7. İstenirse bir araç ipucu ayarlayın.

NOT: Hiperbağlantı hedefi, web URL’lerini yeni, mevcut veya en üst pencerede açmak için sırasıyla _self, _top veya _parent olarak ayarlanabilir.

Aşağıdaki örnek, bir çalışma sayfasına iki hiperbağlantı ekler. Biri hedefi olmaksızın, diğeri ise _parent olarak ayarlanmıştır.

Çıktı: çalışma sayfasına eklenen metin bağlantıları

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Adds a text hyperlink that goes to Aspose site and opens in new window
int linkIndex = sheet.Hyperlinks.Add("B1", "http://www.aspose.com");
GridHyperlink link1 = sheet.Hyperlinks[linkIndex];
link1.Target = "_blank";

// Setting text and tool tip of the hyperlink
link1.TextToDisplay = "Aspose";
link1.ScreenTip = "Open Aspose Web Site in new window";
 
// Adding hyperlink to the worksheet to open in parent window
linkIndex = sheet.Hyperlinks.Add("B2", "http://www.aspose.com/docs/display/cellsnet/Aspose.Cells.GridWeb");
GridHyperlink link2 = sheet.Hyperlinks[linkIndex];
link2.Target = "_parent";

// Setting text and tool tip of the hyperlink
link2.TextToDisplay = "Aspose.Grid Docs";
link2.ScreenTip = "Open Aspose.Grid Docs in parent window";

Resim Hiperbağlantıları

Bir resim hiperbağlantısı eklemek için:

1. Aspose.Cells.GridWeb denetimini Web Formunuza ekleyin.
2. Bir çalışsayı açın.
3. Bir hücreye bir bağlantı ekleyin.
4. Hiperbağlantı olarak görüntülenecek resmin URL’sini ayarlayın.
5. Hiperbağlantının URL’sini ayarlayın.
6. İstenirse bir araç ipucu ayarlayın.
7. İsteniyorsa hiperbağlantı metnini ayarlayın.

Çıktı: çalışma sayfasına eklenen resim hiperbağlantıları

Setting the image hyperlink’s AltText fills a similar function as setting an tag in HTML. The text is displayed only if the hyperlinked image is not displayed. (For example, if the image isn’t at the specified location.) If the image of the second hyperlink is not found, the output of the code snippet below would look as follows.

Resim URL’si bulunamadı

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Adding hyperlink to the worksheet
int linkIndex = sheet.Hyperlinks.Add("B5", "http://www.aspose.com");
GridHyperlink link1 = sheet.Hyperlinks[linkIndex];
link1.Target = "_blank";

// Setting Image URL and tool tip of hyperlink
link1.ImageURL = "../Images/Aspose.Banner.gif";
link1.ScreenTip = "Open Aspose Web Site in new window";

// Adding hyperlink to the worksheet
linkIndex = sheet.Hyperlinks.Add("B6", "http://www.aspose.com/docs/display/cellsnet/Aspose.Cells.GridWeb");
GridHyperlink link2 = sheet.Hyperlinks[linkIndex];
link2.Target = "_blank";

// Setting URL, tool tip and alt text of hyperlink
link2.ImageURL = "../Images/Aspose.Grid.gif";
link2.ScreenTip = "Open Aspose.Grid Docs in new window";
link2.AltText = "Open Aspose.Grid Docs in new window";

// Resize the rows to display image nicely
sheet.Cells.SetRowHeight(4, 40);
sheet.Cells.SetRowHeight(5, 40);

Hücre Komut Hiperbağlantıları

Hücre komut hiperbağlantısı, bir web sayfası açmak yerine sunucu tarafında bir olayı tetikleyen özel bir hiperbağlantı türüdür. Geliştiriciler, hiperbağlantıya tıklandığında sunucu tarafı olayına kod ekleyebilir ve herhangi bir görevi gerçekleştirebilir. Bu özellik, geliştiricilere daha etkileşimli uygulamalar oluşturmalarını sağlar.

Hücre komutu bağlantısını eklemek için:

1. Aspose.Cells.GridWeb denetimini Web Formunuza ekleyin.
2. Bir çalışsayı açın.
3. Bir hücreye bir bağlantı ekleyin.
4. Bağlantının Komutunu istenen herhangi bir değere ayarlayın. Değer, bağlantının olay işleyicisi tarafından tanınması için kullanılır.
5. İstenirse bir araç ipucu ayarlayın.
6. Bağlantı olarak görüntülenecek Görüntü için URL’yi ayarlayın.

Çalışma sayfasına bir hücre komut bağlantısı eklenmiş.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Adding hyperlink to the worksheet
int linkIndex = sheet.Hyperlinks.Add("B8", "");
GridHyperlink link1 = sheet.Hyperlinks[linkIndex];

// Setting the cell command, tool tip and image URL for the hyperlink
link1.Command = "Click";
link1.ScreenTip = "Click Here";
link1.ImageURL = "../Images/button.jpg";

// Resize the row to display image nicely
sheet.Cells.SetRowHeight(7, 30);

Hücre Komutu Bağlantılarının Olay İşlemesi

Geliştiriciler, belirli bir hücre komutu bağlantısı tıklandığında belirli görevleri gerçekleştirmek için GridWeb denetiminin CellCommand etkinliği için bir olay işleyici oluşturmalıdırlar. CellCommand etkinliğinin olay işleyicisi, Argument özelliği sunan CellEventArgs türünde bir nesne sağlar. Bir belirli bağlantıyı tanımlamak için Argument özelliğini kullanın.

Aşağıdaki örnek, yukarıdaki kodda oluşturulan hücre komutu bağlantısı için bir olay işleyici oluşturur. Bağlantının CellCommand’u Tıkla olarak ayarlandı. Bu nedenle, olay işleyicisinde önce kontrol edin ve ardından A6 hücresinde bir ileti gösteren kod ekleyin.

Olay işleyicisi, bağlantı tıklandığında çağrılır.

Çıktı: bağlantı tıklandığında A6 hücresine eklenen metin

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Event Handler for CellCommand event
protected void GridWeb1_CellCommand(object sender, Aspose.Cells.GridWeb.CellEventArgs e)
{
    // Checking the CellCommand of the hyperlink
    if (e.Argument.Equals("Click"))
    {
        // Accessing the reference of the worksheet that is currently active
        GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

        // Adding value to "C8" cell
        sheet.Cells["C8"].PutValue("Cell Command Hyperlink Clicked");

        // Resize the column to display message nicely
        sheet.Cells.SetColumnWidth(2, 250);
    }
}

Bağlantıları Erişme

Mevcut bir bağlantıya erişmek için:

1. İçeren hücreye erişin.
2. Hücre başvurusunu alın.
3. Başvuruyu Hyperlinks koleksiyonunun GetHyperlink yöntemine iletmek için geçirin.
4. Bağlantının özelliklerini değiştirin.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Accessing a specific cell that contains hyperlink
GridCell cell = sheet.Cells["B1"];

// Accessing the hyperlink from the specific cell
GridHyperlink link = sheet.Hyperlinks.GetHyperlink(cell);

if (link != null)
{
    // Modifying the text and URL of hyperlink
    link.TextToDisplay = "Aspose.Blogs";
    link.Address = "http://www.aspose.com/Community/Blogs";
} 

Bağlantıları Kaldırma

Bir bağlantıyı kaldırmak için:

1. Etkin çalışma sayfasına erişin.
2. Hyperlinks koleksiyonunun Kaldır yöntemini kullanarak bir bağlantıyı kaldırın.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];
            
// Removing hyperlink from the specific cell         
sheet.Hyperlinks.Remove(new Data.GridCellArea() {StartRow = 0, EndRow = 0, StartColumn = 1, EndColumn = 1});