Online Reference

Home

Microsoft Reference

Knowledge

Developer

CreateGroupLevel Function

Access Function, ใช้ในการระบุฟิลด์หรือ expression สำหรับการจัดกลุ่มและเรียงลำดับข้อมูลในรายงาน

เช่น การสร้าง Wizard แบบกำหนดเองเพื่อสร้างรายงานที่ให้ผู้ใช้สามารถเลือกฟิลด์ สำหรับใช้ในการจัดกลุ่มและเรียงลำดับข้อมูล โดยเรียกฟังก์ชัน CreateGroupLevel มาการสร้างการจัดกลุ่มตามฟิลด์ที่ผู้ใช้เลือก

ไวยากรณ์

CreateGroupLevel(report, expression, header, footer )

อากิวเมนต์ของฟังก์ชัน CreateGroupLevel มีรายละเอียด คือ

ส่วน	รายละเอียด
report	เป็น expression ของข้อความที่ใช้ระบุชื่อรายงานที่ต้องการสร้างการจัดกลุ่มใหม่
expression	เป็น expression ของข้อความที่ใช้ระบุฟิลด์หรือ expression สำหรับการเรียงหรือการจัดกลุ่ม
header, footer	เป็นค่าตัวเลขจำนวนเต็มที่ใช้ชี้ว่าฟิลด์หรือ expression จะมีส่วนหัวหรือส่วนล่างหรือไม่ ถ้ากำหนดอากิวเมนต์ header หรือ footer เป็น True(-1) ฟิลด์หรือ expression จะมีส่วนหัวหรือส่วนล่าง แต่ถ้ากำหนดอากิวเมนต์ header หรือ footer เป็น False(0) ฟิลด์หรือ expression จะไม่มีส่วนหัวหรือส่วนล่าง ซึ่งสามารถกำหนดให้มีทั้ง 2 ส่วนโดยการกำหนดอากิวเมนต์ header และ footer เป็น True

ลักษณะการประยุกต์

ฟังก์ชัน CreateGroupLevel สามารถใช้ในการออกแบบ Wizard สำหรับการสร้างรายงานที่มีการจัดกลุ่มหรือหาผลรวม ซึ่งฟังก์ชัน CreateGroupLevel จะจัดกลุ่มหรือข้อมูลตามฟิลด์หรือ expression ที่ระบุและสร้างส่วนหัวและส่วนล่างของกลุ่มตามระดับ ฟังก์ชัน CreateGroupLevel ใช้ได้เฉพาะด้าน Design view ของรายงาน

Microsoft Access ใช้ array ของคุณสมบัติ array ของ GroupLevel ในการค้นหาการสร้างระดับกลุ่มให้รายงาน ฟังก์ชัน CreateGroupLevel จะเพิ่มกลุ่มระดับใหม่ให้ array ตามอากิวเมนต์ expression โดยฟังก์ชัน CreateGroupLevel ส่งค่าดัชนีที่แสดงตำแหน่งของกลุ่มระดับใหม่ใน array ซึ่งฟิลด์หรือ expression แรกในการจัดกลุ่มเป็น ระดับ 0 อันดับที่ 2 เป็นระดับ 1 ตามลำดับ การสร้างระดับสามารถทำได้ 10 ระดับ (0 – 9)

การกำหนดอากิวเมนต์ header หรือ footer หรือทั้งสองอากิวเมนต์เป็น True คุณสมบัติ GroupHeader และ GroupFooter ในรายงานจะได้รับการตั้งค่าเป็น Yes จะทำให้ส่วนหัว และ/หรือ ส่วนล่าง จะได้รับการสร้างขึ้นมาตามลำดับของกลุ่ม

เมื่อมีการสร้างส่วนหัว หรือส่วนล่างขึ้นมาแล้ว การกำหนดคุณสมบัติอื่นๆ ได้แก่ GroupOn, GroupInterval และ KeepTogether สามารถตั้งค่าด้วย Visual Basic หรือ ตารางการเรียงและการจัดกลุ่ม (Sorting And Grouping box) ซึ่งเปิดได้โดยการคลิกที่ปุ่ม Sorting And Grouping บนแถบเครื่องมือ

ดูเพิ่มเติม

คุณสมบัติ GroupHeader, คุณสมบัติ Group Footer, คุณสมบัติ GroupGroupInterval, คุณสมบัติ GroupLevel, คุณสมบัติ GroupOn, คุณสมบัติ KeepTogether, คุณสมบัติ SortOrder

ตัวอย่าง

ตัวอย่างการใช้ฟังก์ชัน CreateGroupLevel เพื่อสร้างกลุ่มด้วยฟิลด์ OrderDate ในรายงานชื่อ OrderReport การสร้างกลุ่มของรายงานเป็นการสร้างในด้าน Design view เมื่อกำหนดอากิวเมนต์ header หรือ footer เป็น True(-1) ฟังก์ชันจะสร้างส่วนหัวและส่วนล่างตามระดับกลุ่ม

Sub CreateGL()

Dim varGroupLevel As Variant

' สร้างกลุ่มใหม่ด้วยฟิลด์ OrderDate
varGroupLevel = CreateGroupLevel("OrderReport", "OrderReport", True, True)

  ' ตั้งค่าความสูงของ ส่วนหัว/ส่วนล่าง
  Reports!OrderReport.Selection(acGroupLevelHeader).Height = 400
  Reports!OrderReport.Selection(acGroupLevelFooter).Height = 400

End Sub