E-tablo gruplarına erişme ve bu grupları değiştirme Gruplar, satır veya sütunları gizlemek/göstermek için bir birim olarak genişletilebilir veya daraltılabilir olan bitişik satır veya sütun aralığı arasındaki bir ilişkidir. Her grubun, doğrudan gruptan önce veya sonra (ayarlara bağlı olarak) satır ya da sütunda bulunan ve grubu bir bütün olarak genişletip daraltabilen bir kontrol düğmesi vardır.
Bir grubun derinliği, grubun iç içe yerleştirilmiş konumunu ve grubu kaç tane daha büyük grubun içerdiğini ifade eder. Bir grubun daraltılmış durumu, üst grup genişletildikten sonra grubun daraltılmış veya genişletilmiş olarak kalmasını belirtir. Ayrıca, bir grup daraltıldığında veya genişletildiğinde gruptaki satırlar ya da sütunlar gizlenir ya da görünür olarak ayarlanır. Ancak tek tek satırlar veya sütunlar, daraltılmış durumdan bağımsız olarak gizlenebilir ya da görünür olarak ayarlanabilir.
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 dizini döndürülü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 döndürür. |
remove() | void | Bu grubu e-tablodan kaldırır ve range öğesinin grup derinliğini bir azaltır. |
Ayrıntılı dokümanlar
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 bu grup
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 bu grup
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Control Index()
Bu grubun kontrol açma/kapatma dizini döndürülür. Bu, kontrol düğmesi gruptan önce gösterildiğinde aralıktan hemen önceki dizindir. 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 bulunduğu aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Collapsed()
Bu grup daraltılmışsa true
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
: Bu grup daraltılmışsa true
, aksi takdirde false
döndürülür.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
Bu grubu e-tablodan kaldırır ve range
öğesinin grup derinliğini bir azaltır. Bu işlem diğer grupları değiştirebilir. Bu çağrıdan 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets