Başlık ve Altbilgileri Ayarlama

Başlık ve Altbilgileri Ayarlama

Aspose.Cells, çalışma sayfalarına çalışma zamanında başlıklar ve altbilgiler eklemenize olanak tanır, ancak yazdırma için önceden tasarlanmış bir dosyada başlık ve altbilgileri manuel olarak ayarlamanızı öneririz. Çaba ve geliştirme zamanı tasarrufu yapmak için Microsoft Excel’i başlık ve altbilgileri ayarlamak için bir GUI aracı olarak kullanabilirsiniz. Aspose.Cells, dosyayı içe aktarabilir ve ayarlamaları kaydedebilir.

Çalışma zamanında başlık ve altbilgiler eklemek için Aspose.Cells, özel API çağrıları ve betik komutları sağlar.

Betik Komutları

Betik komutları, başlık ve altbilgi biçimlendirmesini ayarlamanıza olanak tanıyan özel komutlardır.

Betik Komutları Açıklama
&P Geçerli sayfa numarası
&G Bir resim
&N Toplam sayfa sayısı
&D Geçerli tarih
&T Geçerli saat
&A Çalışma sayfası adı
&F Dosya adı ve yolu olmadan
&"<FontName>" Yazı tipi adını temsil eder. Örneğin: &“Arial”
&"<FontName>, <FontStyle>" Stil ile yazı tipi adını temsil eder. Örneğin: &“Arial,Kalın”
&<FontSize> Yazı tipi boyutunu temsil eder. Örneğin: “&14abc”. Ancak, bu komuttan sonra başlığa yazdırılacak düz bir sayı izlenecekse, bu, yazı tipi boyutundan bir boşluk karakteri ile ayrılmalıdır. Örneğin: “&14 123”.

Başlık ve Altbilgileri Ayarlama

PageSetup sınıfı, çalışma sayfasına başlık ve altbilgi eklemek için kullanılan SetHeader ve SetFooter adlı iki yöntem sağlar. Bu yöntemler yalnızca iki parametre alır:

  • Bölüm – başlığın veya altbilginin yerleştirileceği bölüm. Sırasıyla sol, merkez ve sağ olmak üzere temsil edilen üç bölüm bulunmaktadır.
  • Betik – başlık veya altbilgi için kullanılacak betik. Bu betik, başlıkları veya altbilgileri biçimlendirmek için betik komutları içerir.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Instantiating a Workbook object
Workbook excel = new Workbook();
// Obtaining the reference of the PageSetup of the worksheet
PageSetup pageSetup = excel.Worksheets[0].PageSetup;
// Setting worksheet name at the left section of the header
pageSetup.SetHeader(0, "&A");
// Setting current date and current time at the centeral section of the header
// and changing the font of the header
pageSetup.SetHeader(1, "&\"Times New Roman,Bold\"&D-&T");
// Setting current file name at the right section of the header and changing the
// font of the header
pageSetup.SetHeader(2, "&\"Times New Roman,Bold\"&12&F");
// Setting a string at the left section of the footer and changing the font
// of a part of this string ("123")
pageSetup.SetFooter(0, "Hello World! &\"Courier New\"&14 123");
// Setting the current page number at the central section of the footer
pageSetup.SetFooter(1, "&P");
// Setting page count at the right section of footer
pageSetup.SetFooter(2, "&N");
// Save the Workbook.
excel.Save("SetHeadersAndFooters_out.xls");

Bir Resmi Başlık veya Altbilgiye Ekleyin

PageSetup sınıfı, başlığa ve altbilgiye resim eklemek için kullanılan SetHeaderPicture ve SetFooterPicture adlı iki ek yönteme sahiptir. Bu yöntemlerle şu parametreler alınır:

  • Bölüm – resmin yerleştirileceği başlık veya altbilgi bölümü. Sırasıyla sol, merkez ve sağ olmak üzere temsil edilen üç bölüm bulunmaktadır.
  • Bayt dizisi – görsel veri (ikili veri bir byte dizisinin tamponuna yazılmalıdır).

Aşağıdaki kodu çalıştırdıktan sonra dosyayı açarak, çalışma sayfasının üstbilgisini kontrol edin:

  1. Dosya menüsünde Sayfa Düzeni‘ni seçin. Bir iletişim kutusu görüntülenecektir.
  2. Üst Bilgi/Alt Bilgi sekmesini seçin.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
// Creating a Workbook object
Workbook workbook = new Workbook();
// Creating a string variable to store the url of the logo/picture
string logo_url = dataDir + "aspose-logo.jpg";
// Declaring a FileStream object
FileStream inFile;
// Declaring a byte array
byte[] binaryData;
// Creating the instance of the FileStream object to open the logo/picture in the stream
inFile = new System.IO.FileStream(logo_url, System.IO.FileMode.Open, System.IO.FileAccess.Read);
// Instantiating the byte array of FileStream object's size
binaryData = new Byte[inFile.Length];
// Reads a block of bytes from the stream and writes data in a given buffer of byte array.
long bytesRead = inFile.Read(binaryData, 0, (int)inFile.Length);
// Creating a PageSetup object to get the page settings of the first worksheet of the workbook
PageSetup pageSetup = workbook.Worksheets[0].PageSetup;
// Setting the logo/picture in the central section of the page header
pageSetup.SetHeaderPicture(1, binaryData);
// Setting the script for the logo/picture
pageSetup.SetHeader(1, "&G");
// Setting the Sheet's name in the right section of the page header with the script
pageSetup.SetHeader(2, "&A");
// Saving the workbook
workbook.Save(dataDir + "InsertImageInHeaderFooter_out.xls");
//Closing the FileStream object
inFile.Close();