E-tablo gruplarına erişme ve bunları değiştirme Gruplar, satır veya sütunları gizlemek/göstermek için bir birim olarak genişletilebilen ya da daraltılabilen, bitişik satır veya sütun aralığı arasındaki ilişkilendirmedir. Her grubun, grubun hemen öncesindeki veya sonrasındaki satır ya da sütunda (ayarlara bağlı olarak) grubu bir bütün olarak genişletebilen veya daraltabilen bir kontrol açma/kapatma düğmesi vardır.
Bir grubun derinliği, grubun iç içe yerleştirilmiş konumunu ve grubu içeren daha büyük grupların sayısını ifade eder. Bir grubun daraltılmış durumu, üst grup genişletildikten sonra grubun daraltılmış mı yoksa genişletilmiş mi kalacağını ifade eder. Ayrıca, bir grup daraltıldığında veya genişletildiğinde, gruptaki satırlar ya da sütunlar gizlenir veya görünür hale getirilir. Bununla birlikte, daraltılmış durumdan bağımsız olarak satırlar ya da sütunlar ayrı ayrı gizlenebilir veya görünür hale getirilebilir.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
collapse() | Group | Bu grubu daraltır. |
expand() | Group | Bu grubu genişletir. |
get | Integer | Bu grubun kontrol açma/kapatma dizinini döndürür. |
get | Integer | Bu grubun derinliğini döndürür. |
get | Range | Bu grubun bulunduğu aralığı döndürür. |
is | Boolean | Bu grup daraltılmışsa true değerini döndürür. |
remove() | void | Bu grubu sayfadan kaldırarak range öğesinin grup derinliğini bir azaltır. |
Ayrıntılı belgeler
collapse()
Bu grubu daraltır.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getRange('2:3'); range.shiftRowGroupDepth(1); const group = sheet.getRowGroup(2, 1); // Collapses this group. group.collapse();
Return
Group
: Zincirleme için kullanılan bu grup.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expand()
Bu grubu genişletir.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getRange('2:3'); range.shiftRowGroupDepth(1); const group = sheet.getRowGroup(2, 1); // Expands this group. group.expand();
Return
Group
: Zincirleme için kullanılan bu grup.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Control Index()
Bu grubun kontrol açma/kapatma dizinini döndürür. Bu, kontrol açma/kapatma düğmesi gruptan önce gösterildiğinde aralıktan hemen önceki dizin, aksi takdirde aralıktan hemen sonraki dizindir.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setRowGroupControlAfter(true); const range = sheet.getRange('2:3'); range.shiftRowGroupDepth(1); const group = sheet.getRowGroup(2, 1); // Returns 4 const controlIndex = group.getControlIndex();
Return
Integer
: Bu grubun kontrol açma/kapatma dizini.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Depth()
Bu grubun derinliğini döndürür.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getRange('2:3'); range.shiftRowGroupDepth(1); const group = sheet.getRowGroup(2, 1); // Returns 1 if the group is at depth 1. const depth = group.getDepth();
Return
Integer
: Bu grubun derinliği.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Range()
Bu grubun bulunduğu aralığı döndürür.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; let range = sheet.getRange('2:3'); range.shiftRowGroupDepth(1); const group = sheet.getRowGroup(1, 1); // Returns the range 2:3 if the group is over rows 2:3 range = group.getRange();
Return
Range
: Grubun var olduğu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Collapsed()
Bu grup daraltılmışsa true
değerini döndürür.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getRange('2:3'); range.shiftRowGroupDepth(1); const group = sheet.getRowGroup(2, 1); // Returns true if the group is collapsed. const isCollapsed = group.isCollapsed();
Return
Boolean
— true
Bu grup daraltılmışsa false
değerini, aksi takdirde başka bir değeri döndürür.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
Bu grubu sayfadan kaldırarak range
öğesinin grup derinliğini bir azaltır. Bu işlem diğer grupları değiştirebilir. Bu işlev çağrıldıktan sonra grup nesnesi kullanılamaz hale gelir.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; let range = sheet.getRange('2:3'); range.shiftRowGroupDepth(1); const group = sheet.getRowGroup(2, 1); // Removes this group range = group.remove();
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets