Çalışma Sayfasındaki Köprüleri Yönetin

Bu konuda, Aspose.Cells.GridWeb’de ne tür köprülerin desteklendiği ve bunların programlı olarak nasıl yönetileceği anlatılmaktadır. Köprüler, web URL’lerine bağlantılar oluşturmak veya bir sunucuya geri gönderme gerçekleştirmek için kullanılabilir.

Köprülerle Çalışmak

Köprü Türleri

Genel olarak, aşağıdaki köprüler Aspose.Cells.GridWeb tarafından desteklenir:

• URL köprüleri, web URL’lerine bağlanabilen köprüler.
• Metin köprüleri, metne uygulanan URL köprüleri.
• Görüntü köprüleri, Resimlere uygulanan URL köprüleri.
• Cell komut köprüleri, verileri bir sunucuya gönderen köprüler. Bu tür köprüler, tıklandığında sunucu tarafı olayını tetikleyen bir düğme gibi davranır.

Aşağıdaki bölümlerde, her tür köprünün kullanımı ayrıntılı olarak açıklanmaktadır. Ayrıca bağlantılara nasıl erişileceğini veya kaldırılacağını da tartışır.

Köprü Ekleme

URL Köprüleri

URL köprüleri, normalde web sitelerinde gördüğünüz basit köprülere benzer. URL köprüsü, hücredeki bir bağlantı gibi çalışır. Tıklandığında, bir web sayfasına gider veya yeni bir tarayıcı penceresi açar.

Farklı türde URL köprüleri vardır:

• Metin köprüleri.
• Görüntü köprüleri.

Geliştiriciler, köprü için bir görüntü belirtebilir. Bir görüntü belirtilmezse, bir metin köprüsü oluşturulur; aksi takdirde bir görüntü köprüsü oluşturulur.

Metin Köprüleri

Bir çalışma sayfasına metin köprüsü eklemek için:

1. Aspose.Cells.GridWeb denetimini Web Formunuza ekleyin.
2. Bir çalışma sayfasına erişin.
3. Çalışma sayfasındaki bir hücreye köprü ekleyin.
4. Hücrede gösterilecek metni ayarlayın.
5. Köprünün URL’sini ayarlayın.
6. İsterseniz köprünün hedefini ayarlayın.
7. İstenirse bir araç ucu ayarlayın.

NOT: Köprü hedefi şu şekilde ayarlanabilir:_ öz,_top veya _parent, web URL’lerini sırasıyla yeni, geçerli veya üst pencerede açmak için.

Aşağıdaki örnek, bir çalışma sayfasına iki köprü ekler. Birinin hedefi yok, diğeri ise _parent olarak ayarlı.

Çıktı: çalışma sayfasına eklenen metin köprüleri

// 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";

Görüntü Köprüleri

Bir resim köprüsü eklemek için:

1. Aspose.Cells.GridWeb denetimini Web Formunuza ekleyin.
2. Bir çalışma sayfasına erişin.
3. Bir hücreye köprü ekleyin.
4. Köprü olarak görüntülenecek görüntünün URL’sini ayarlayın.
5. Köprü URL’sini ayarlayın.
6. İstenirse bir araç ucu ayarlayın.
7. İsterseniz köprü metnini ayarlayın.

Çıktı: çalışma sayfasına eklenen görüntü köprüleri

Görüntü köprüsünün AltText’ini ayarlamak, bir HTML’deki etiket. Metin yalnızca köprü bağlantılı resim görüntülenmiyorsa görüntülenir. (Örneğin, resim belirtilen konumda değilse.) İkinci köprünün resmi bulunmazsa, aşağıdaki kod parçacığının çıktısı aşağıdaki gibi görünecektir.

Resim URL’si için resim 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);

Cell Komut Köprüleri

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

Bir hücre komutu köprüsü eklemek için:

1. Aspose.Cells.GridWeb denetimini Web Formunuza ekleyin.
2. Bir çalışma sayfasına erişin.
3. Bir hücreye köprü ekleyin.
4. Köprünün Komutunu istediğiniz herhangi bir değere ayarlayın. Değer, köprünün olay işleyicisi tarafından onu tanımak için kullanılır.
5. İstenirse bir araç ucu ayarlayın.
6. Köprü olarak görüntülenecek Görüntü için URL’yi ayarlayın.

Çalışma sayfasına bir hücre komut köprüsü eklendi

// 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);

Cell Komut Köprülerinin Olay İşleme

Geliştiricilerin, belirli bir hücre komut köprüsü tıklandığında belirli görevleri gerçekleştirmek üzere GridWeb denetiminin CellCommand olayı için bir olay işleyicisi oluşturması gerekir. CellCommand olayının olay işleyicisi, Argument özelliğini sunan CellEventArgs türünde bir nesne sağlar. CellCommand değerini karşılaştırarak belirli bir köprüyü tanımlamak için Argument özelliğini kullanın.

Aşağıdaki örnek, yukarıdaki kodda oluşturulan hücre komut köprüsü için bir olay işleyici oluşturur. Köprünün CellCommand’ı Click olarak ayarlandı. Bu nedenle, olay işleyicide önce kontrol edin ve ardından A6 hücresinde bir mesaj görüntüleyen kodu ekleyin.

Olay işleyicisi, köprü tıklandığında çağrılır.

Çıktı: köprü 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);
    }
}

Köprülere Erişim

Mevcut bir köprüye erişmek için:

1. Onu içeren hücreye erişin.
2. Hücre referansını alın.
3. Köprüye erişmek için başvuruyu Köprüler koleksiyonunun GetHyperlink yöntemine iletin.
4. Köprü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";
} 

Köprüleri Kaldırma

Bir köprüyü kaldırmak için:

1. Etkin çalışma sayfasına erişin.
2. Köprüler koleksiyonunun Kaldır yöntemini kullanarak bir köprü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});