Class Group

Grup

E-tablo gruplarına erişebilir ve bunları değiştirebilir. Gruplar, satırları veya sütunları gizlemek/göstermek için birim olarak genişletilebilen veya daraltılabilen bitişik satır ya da sütun aralığı arasındaki ilişkilendirmedir. Her grubun, satır veya sütunda grubun hemen öncesinde veya sonrasında grup halinde genişletilebilen veya daraltılabilen (ayarlara bağlı olarak) 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 grup sayısını ifade eder. Bir grubun daraltılmış durumu, üst grup genişletildikten sonra grubun daraltılmış veya genişletilmiş olarak kalması gerekip gerekmediğini belirtir. Buna ek olarak, bir grup daraltıldığında veya genişletildiğinde, grup içindeki satırlar ya da sütunlar gizlenir veya görünür olarak ayarlanır. Bununla birlikte, 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öntemDönüş türüKısa açıklama
collapse()GroupBu grubu daraltır.
expand()GroupBu grubu genişletir.
getControlIndex()IntegerBu grubun kontrol açma/kapatma dizinini döndürür.
getDepth()IntegerBu grubun derinliğini döndürür.
getRange()RangeBu grubun bulunduğu aralığı döndürür.
isCollapsed()BooleanBu grup daraltılmışsa true değerini döndürür.
remove()voidBu grubu sayfadan kaldırarak range öğesinin grup derinliğini bir azaltabilirsiniz.

Ayrıntılı belgeler

collapse()

Bu grubu daraltır.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange(2:3);
range.shiftRowGroupDepth(1);
var group = sheet.getRowGroup(2, 1);

// Collapses this group.
group.collapse();

Return

Group — bu grup, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange(2:3);
range.shiftRowGroupDepth(1);
var group = sheet.getRowGroup(2, 1);

// Expands this group.
group.expand();

Return

Group — bu grup, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getControlIndex()

Bu grubun kontrol açma/kapatma dizinini döndürür. Bu, denetim açma/kapatma düğmesinin gruptan önce gösterildiği aralıktan hemen önceki dizindir; aksi takdirde, aralıktan hemen sonra gelen dizindir.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setRowGroupControlAfter(true);
var range = sheet.getRange(2:3);
range.shiftRowGroupDepth(1);
var group = sheet.getRowGroup(2, 1);

// Returns 4
var controlIndex = group.getControlIndex();

Return

Integer — bu grubun kontrol açma/kapatma dizini

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDepth()

Bu grubun derinliğini döndürür.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange(2:3);
range.shiftRowGroupDepth(1);
var group = sheet.getRowGroup(2, 1);

// Returns 1 if the group is at depth 1.
var depth = group.getDepth();

Return

Integer — bu grubun derinliği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRange()

Bu grubun bulunduğu aralığı döndürür.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange(2:3);
range.shiftRowGroupDepth(1);
var 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ı, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

isCollapsed()

Bu grup daraltılmışsa true değerini döndürür.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange(2:3);
range.shiftRowGroupDepth(1);
var group = sheet.getRowGroup(2, 1);

// Returns true if the group is collapsed.
var isCollapsed = group.isCollapsed();

Return

Boolean — Bu grup daraltılmışsa true; aksi takdirde false değerini döndürür

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 azaltabilirsiniz. Bu işlem diğer grupları değiştirebilir. Bu çağrıdan sonra, grup nesnesi artık kullanılamaz hale gelir.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange(2:3);
range.shiftRowGroupDepth(1);
var group = sheet.getRowGroup(2, 1);

// Removes this group
var range = group.remove();

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Aşağıdaki kaynakları da incelemenizi öneririz: