The constructor used by this exampl

The constructor used by this example takes three arguments. The first indicates the split direction. The other arguments are the two components to put in the split pane. Refer to Setting the Components in a Split Pane for information about JSplitPane methods that set the components dynamically.

The split pane in this example is split horizontally — the two components appear side by side — as specified by the JSplitPane.HORIZONTAL_SPLIT argument to the constructor. Split pane provides one other option, specified with JSplitPane.VERTICAL_SPLIT, that places one component above the other. You can change the split direction after the split pane has been created with the setOrientation method.

Two small arrows appear at the top of the divider in the example's split pane. These arrows let the user collapse (and then expand) either of the components with a single click. The current look and feel determines whether these controls appear by default. In the Java look and feel, they are turned off by default. (Note that not all look and feels support this.) The example turned them on using the setOneTouchExpandable method.

The range of a split pane's divider is determined in part by the minimum sizes of the components within the split pane. See Positioning the Divider and Restricting its Range for details.

The rest of this section covers these topics:

Setting the Components in a Split Pane
Positioning the Divider and Restricting its Range
Nesting Split Panes
The Split Pane API
Examples that Use Split Panes

Setting the Components in a Split Pane

A program can set a split pane's two components dynamically with these four methods:

setLeftComponent
setRightComponent
setTopComponent
setBottomComponent
You can use any of these methods at any time regardless of the split pane's current split direction. Calls to setLeftComponent and setTopComponent are equivalent and set the specified component in the top or left position, depending on the split pane's current split orientation. Similarly, calls to setRightComponent and setBottomComponent are equivalent. These methods replace whatever component is already in that position with the new one.

Like other containers, JSplitPane supports the add method. Split pane puts the first component added in the left or top position. The danger of using add is that you can inadvertantly call it too many times, in which case the split pane's layout manager will throw a rather esoteric-looking exception. If you are using the add method and a split pane is already populated, you first need to remove the existing components with remove.

If you put only one component in a split pane, then the divider will be stuck at the right side or the bottom of the split pane, depending on its split direction.

Positioning the Divider and Restricting Its Range

To make your split pane work well, you often need to set the minimum sizes of components in the split pane, as well as the preferred size of either the split pane or its contained components. Choosing which sizes you should set is an art that requires understanding how a split pane's preferred size and divider location are determined. Before we get into details, let's take another look at SplitPaneDemo. Or, if you're in a hurry, you can skip to the list of rules.

ผลลัพธ์ (ไทย) 1:

ตัวสร้างที่ใช้ตามตัวอย่างนี้ใช้อาร์กิวเมนต์ที่สาม แรกที่บ่งชี้ทิศทางแยก อาร์กิวเมนต์เป็นส่วนประกอบทั้งสองใส่ในบานหน้าต่างแยก ดูการตั้งค่าส่วนประกอบในบานหน้าต่างแยกสำหรับข้อมูลเกี่ยวกับวิธีการ JSplitPane ที่เนื้อหาแบบไดนามิกแบ่งบานหน้าต่างในตัวอย่างนี้ถูกแบ่งออกในแนวนอน — ส่วนสองปรากฏอยู่เคียงข้าง — ตามที่ระบุ โดยอาร์กิวเมนต์ตัวสร้าง JSplitPane.HORIZONTAL_SPLIT บานแบ่งให้หนึ่งตัวเลือกอื่น ๆ ระบุ ด้วย JSplitPane.VERTICAL_SPLIT ที่วางคอมโพเนนต์หนึ่งข้างอีก คุณสามารถเปลี่ยนทิศทางแยกหลังจากที่มีการสร้างหน้าต่างแยก ด้วยวิธี setOrientationลูกศรเล็กสองปรากฏที่ด้านบนของตัวแบ่งในบานหน้าต่างตัวอย่างแยก ลูกศรเหล่านี้ให้ผู้ใช้ยุบแล้ว ขยาย) อย่างใดอย่างหนึ่งประกอบด้วยคลิกเดียว ปัจจุบันลักษณะและความรู้สึกกำหนดว่า ตัวควบคุมเหล่านี้ปรากฏตามค่าเริ่มต้น ในการจาวาลักษณ์ พวกเขาจะถูกปิด โดยค่าเริ่มต้น (หมายเหตุว่า ให้ความรู้สึกและดูไม่สนับสนุนนี้) ตัวอย่างการเปิดพวกเขาใช้วิธี setOneTouchExpandableหลากหลายของบานหน้าต่างแยกแบ่งถูกกำหนดบางส่วน โดยขนาดต่ำสุดของชิ้นส่วนภายในบานหน้าต่างแยก ดูตำแหน่งตัวแบ่ง และจำกัดช่วงของรายละเอียดส่วนเหลือของส่วนนี้ครอบคลุมหัวข้อเหล่านี้:การตั้งค่าส่วนประกอบในบานหน้าต่างแยกแบ่งการวางตำแหน่งและการจำกัดช่วงของเนสติ้งแบ่งบานบานแบ่ง APIตัวอย่างที่ใช้แบ่งบานการตั้งค่าส่วนประกอบในบานหน้าต่างแยกโปรแกรมสามารถตั้งบานแบ่งเป็นสองส่วนแบบไดนามิก ด้วยวิธีการสี่เหล่านี้:setLeftComponentsetRightComponentsetTopComponentsetBottomComponentคุณสามารถใช้ใด ๆ ของวิธีการเหล่านี้ตลอดเวลาโดยของบานหน้าต่างแยกปัจจุบันแยกทิศทาง โทร setLeftComponent และ setTopComponent เทียบเท่า และตั้งค่าคอมโพเนนต์ที่ระบุด้านบน หรือด้านซ้ายตำแหน่ง ตามบานหน้าต่างแยกปัจจุบันแบ่งแนว ในทำนองเดียวกัน เรียก setRightComponent และ setBottomComponent จะเทียบเท่า วิธีการเหล่านี้แทนส่วนประกอบใดอยู่ในตำแหน่งนั้นด้วยเช่นบรรจุภัณฑ์อื่น ๆ JSplitPane สนับสนุนวิธีการเพิ่ม แบ่งบานทำให้ส่วนประกอบแรกที่เพิ่มในตำแหน่งด้านซ้าย หรือด้านบน อันตรายของการใช้เพิ่มเป็นที่คุณสามารถ inadvertantly เรียกหลายครั้งเกินไป ในกรณี ผู้จัดการเค้าโครงของหน้าต่างแยกจะโยนข้อยกเว้นที่ค่อนข้างลึกลับดู ถ้าคุณใช้วิธีการเพิ่ม และบานแบ่งแล้วได้รวบรวม ก่อนอื่นคุณต้องลบส่วนประกอบที่มีอยู่กับเอาถ้าคุณใส่องค์ประกอบหนึ่งเท่านั้นในบานหน้าต่างแยก แล้วแบ่งที่จะได้ติดอยู่ที่ด้านขวาหรือด้านล่างของบานหน้าต่างแยก ขึ้นอยู่กับทิศทางการแบ่งของแบ่งการวางตำแหน่งและการจำกัดช่วงของต้องการแบ่งบานของคุณ ทำงานดี คุณมักจะต้องตั้งขนาดต่ำสุดของส่วนประกอบในบานหน้าต่างแยก ขนาดต้องแบ่งบานหน้าต่างหรือส่วนประกอบมีอยู่ เลือกขนาดใดคุณควรตั้งค่าเป็นศิลปะที่ต้องทำความเข้าใจเกี่ยวกับวิธีกำหนดขนาดที่ต้องการของบานหน้าต่างแยกและแบ่งตำแหน่ง ก่อนที่เราจะลงรายละเอียด ลองมาดูอีกที่ SplitPaneDemo ขึ้น ถ้าคุณไม่รีบ คุณสามารถข้ามไปยังรายการของกฎ

ผลลัพธ์ (ไทย) 2:

ตัวสร้างที่ใช้โดยตัวอย่างนี้ใช้เวลาสามข้อโต้แย้ง ครั้งแรกที่แสดงให้เห็นทิศทางที่แยก ข้อโต้แย้งอื่น ๆ เป็นสองส่วนที่จะใส่ในบานหน้าต่างแยก . โปรดดูที่การตั้งค่าส่วนประกอบในบานหน้าต่างแยกสำหรับข้อมูลเกี่ยวกับวิธีการ JSplitPane ที่ตั้งองค์ประกอบแบบไดนามิกบานหน้าต่างแยกในตัวอย่างนี้ถูกแบ่งออกในแนวนอน- ทั้งสองส่วนจะปรากฏเคียงข้าง - ตามที่ระบุโดยอาร์กิวเมนต์ JSplitPane.HORIZONTAL_SPLIT ที่จะสร้าง บานหน้าต่างแยกให้เป็นหนึ่งในตัวเลือกอื่น ๆ ที่ระบุไว้กับ JSplitPane.VERTICAL_SPLIT ที่วางองค์ประกอบหนึ่งเหนือผู้อื่น คุณสามารถเปลี่ยนทิศทางหลังจากแยกบานหน้าต่างที่แยกได้ถูกสร้างขึ้นด้วยวิธี setOrientation. สองลูกศรขนาดเล็กอยู่ด้านบนของแบ่งในบานหน้าต่างแยกตัวอย่างของ ลูกศรเหล่านี้ช่วยให้การล่มสลายผู้ใช้ (แล้วขยาย) อย่างใดอย่างหนึ่งขององค์ประกอบที่ได้ด้วยคลิกเดียว รูปลักษณ์และความรู้สึกปัจจุบันกำหนดว่าการควบคุมเหล่านี้จะปรากฏโดยค่าเริ่มต้น ในลักษณะ Java และความรู้สึกที่พวกเขาจะปิดโดยปริยาย (ไม่ทราบว่าทุกคนมองและรู้สึกสนับสนุนนี้.) ตัวอย่างที่เปิดให้เกี่ยวกับการใช้วิธีการ setOneTouchExpandable. ช่วงของการกั้นของบานหน้าต่างแยกจะถูกกำหนดในส่วนของขนาดต่ำสุดของชิ้นส่วนภายในบานหน้าต่างแยก . ดูตำแหน่ง Divider และการ จำกัด ช่วงของสำหรับรายละเอียดส่วนที่เหลือของส่วนนี้ครอบคลุมหัวข้อเหล่านี้: การตั้งค่าส่วนประกอบในสปลิตบานหน้าต่างจัดตำแหน่ง Divider และการ จำกัด ช่วงของรังแยกบานหน้าต่างแยกบานหน้าต่างAPI ตัวอย่างการใช้แยกบานหน้าต่างการตั้งค่าส่วนประกอบในบานหน้าต่างแยกโปรแกรมสามารถตั้งบานหน้าต่างแยกของสององค์ประกอบแบบไดนามิกกับทั้งสี่วิธีการ: setLeftComponent setRightComponent setTopComponent setBottomComponent คุณสามารถใช้วิธีการเหล่านี้ได้ตลอดเวลาโดยไม่คำนึงถึงทิศทางแยกปัจจุบันบานหน้าต่างแยกของ โทรไป setLeftComponent และ setTopComponent เทียบเท่าและกำหนดองค์ประกอบที่ระบุในตำแหน่งบนสุดหรือซ้ายขึ้นอยู่กับปัจจุบันแยกบานหน้าต่างแยกของการวางแนวทาง ในทำนองเดียวกันเรียกร้องให้ setRightComponent และ setBottomComponent เทียบเท่า วิธีการเหล่านี้แทนที่สิ่งที่องค์ประกอบที่มีอยู่แล้วในตำแหน่งนั้นด้วยใหม่. เช่นเดียวกับภาชนะอื่น ๆ , JSplitPane สนับสนุนวิธีการเพิ่ม บานหน้าต่างแยกทำให้องค์ประกอบแรกเพิ่มในตำแหน่งซ้ายหรือด้านบน อันตรายจากการใช้เพิ่มคือการที่คุณ inadvertantly สามารถเรียกมันหลายครั้งเกินไปในกรณีที่รูปแบบบานหน้าต่างแยกผู้จัดการจะโยนข้อยกเว้นค่อนข้างลึกลับมอง ถ้าคุณกำลังใช้วิธีการเพิ่มและบานหน้าต่างแยกเป็นประชากรแล้วคุณต้องเอาส่วนประกอบที่มีอยู่กับลบ. หากคุณใส่เพียงองค์ประกอบหนึ่งในบานหน้าต่างแยกแล้วแบ่งจะได้รับการติดอยู่ที่ด้านขวาหรือด้านล่าง ของบานหน้าต่างแยกขึ้นอยู่กับทิศทางแยกของ. ตำแหน่ง Divider และการ จำกัด ช่วงของมันเพื่อให้งานบานหน้าต่างแยกของคุณดีคุณมักจะต้องกำหนดขนาดต่ำสุดขององค์ประกอบในบานหน้าต่างแยกเช่นเดียวกับขนาดที่ต้องการของทั้งบานหน้าต่างหรือแยกส่วนประกอบที่มีอยู่ เลือกที่ขนาดคุณควรตั้งเป็นศิลปะที่ต้องใช้ความเข้าใจวิธีการที่บานหน้าต่างขนาดที่ต้องการแยกและสถานที่ตั้งกั้นจะถูกกำหนด ก่อนที่เราจะเข้าไปในรายละเอียดให้มาดูที่ SplitPaneDemo อื่น หรือถ้าคุณอยู่ในรีบคุณสามารถข้ามไปยังรายการของกฎ

ผลลัพธ์ (ไทย) 3:

คอนสตรัคใช้ตัวอย่างนี้ใช้อาร์กิวเมนต์ 3 แรกแสดงแยกทิศทาง ข้อโต้แย้งอื่น ๆที่มีสององค์ประกอบที่จะใส่ในการแยกบ้าน อ้างถึงการตั้งค่าคอมโพเนนต์ในการแยกช่องสำหรับข้อมูลเกี่ยวกับวิธีการตั้งค่า jsplitpane

องค์ประกอบแบบไดนามิกการแบ่งช่องในตัวอย่างนี้จะแยกตามแนวนอน - สององค์ประกอบปรากฏเคียงข้าง -- ตามที่ระบุไว้โดย jsplitpane.horizontal_split อาร์กิวเมนต์ไปยังผู้สร้าง แยกช่องให้หนึ่งตัวเลือกอื่น ๆที่ระบุไว้ jsplitpane.vertical_split , ที่สถานที่องค์ประกอบหนึ่งข้างต้นอื่น ๆคุณสามารถเปลี่ยนแยกทิศทางหลังจากที่แยกหน้าต่างได้ถูกสร้างขึ้นด้วยวิธี setorientation

สองขนาดเล็กลูกศรปรากฏที่ด้านบนของการแบ่งในตัวอย่างแยกเป็นบานหน้าต่าง . ลูกศรเหล่านี้ให้ผู้ใช้ยุบ ( และขยาย ) ของส่วนประกอบด้วยคลิกเดียว ปัจจุบันดู และรู้สึกว่าควบคุมเหล่านี้จะปรากฏตามค่าเริ่มต้น ในจาวามองและรู้สึกพวกเขาจะปิดโดยค่าเริ่มต้น ( โปรดสังเกตว่า ไม่ได้ดู และรู้สึกสนับสนุนนี้ ) ตัวอย่างเปิดพวกเขาในวิธี setonetouchexpandable

ช่วงแบ่งแยกช่องเป็นจะพิจารณาในส่วนของขนาดขั้นต่ำขององค์ประกอบภายในแยกบ้าน เห็นการแบ่งและ จำกัด ช่วงของรายละเอียด

ส่วนที่เหลือของหมวดนี้ครอบคลุมหัวข้อเหล่านี้ :

การแยกองค์ประกอบในบานหน้าต่าง
ตำแหน่งแบ่งและ จำกัด ช่วงของการแบ่งบาน


ตัวอย่างบานหน้าต่างแยก API ที่ใช้แบ่งบาน

การตั้งค่าคอมโพเนนต์ในการแยกช่อง

โปรแกรมสามารถตั้งค่าแยกบานหน้าต่างสององค์ประกอบแบบไดนามิกที่มีวิธีการเหล่านี้สี่ :



settopcomponent setleftcomponent setrightcomponent

setbottomcomponentคุณสามารถใช้ใด ๆของวิธีการเหล่านี้ในเวลาใด ๆโดยไม่คำนึงถึงทิศทางที่แบ่งแยกหน้าต่างปัจจุบัน และโทรไป setleftcomponent settopcomponent เทียบเท่าและชุดส่วนประกอบที่ระบุไว้ในด้านบนซ้ายหรือตำแหน่ง ขึ้นอยู่กับการแบ่งแยกหน้าต่างปัจจุบัน ในทํานองเดียวกัน โทรไป setrightcomponent และ setbottomcomponent มีค่าเท่ากันวิธีการเหล่านี้แทนที่สิ่งที่เป็นองค์ประกอบอยู่ในตำแหน่งนั้นด้วยใหม่

เหมือนภาชนะอื่น ๆ jsplitpane สนับสนุนเพิ่มวิธีการ แยกช่องใส่ส่วนประกอบแรกเพิ่มในตำแหน่งซ้ายหรือด้านบน อันตรายจากการใช้เพิ่มคือการ ที่คุณสามารถ inadvertantly เรียกหลายครั้งแล้ว ซึ่งในกรณีนี้ผู้จัดการเค้าโครงบานหน้าต่างแยกจะโยนค่อนข้างลึกลับดูข้อยกเว้นถ้าคุณใช้เพิ่มวิธีการแยกช่องเป็นข้อมูลแรกคุณจะต้องเอาชิ้นส่วนที่มีอยู่กับเอา

ถ้าคุณใส่เพียงองค์ประกอบหนึ่งในการแยกช่อง แล้วแบ่งจะถูกติดอยู่ที่ด้านขวาหรือด้านล่างของบานหน้าต่างแยก , แยก
ขึ้นอยู่กับทิศทางของ
วางกั้นและจำกัดช่วง

เพื่อให้แยกที่ทำงานดีคุณมักจะต้องกำหนดขนาดขั้นต่ำขององค์ประกอบในการแบ่งช่อง ตลอดจนขนาด ที่ต้องการให้แบ่งบานหน้าต่างหรือที่มีส่วนประกอบ เลือกที่ขนาดคุณควรตั้งค่าเป็นศิลปะที่ต้องมีความเข้าใจวิธีการแบ่งช่องที่ต้องการขนาดและแบ่งที่ตั้งกำหนดไว้ ก่อนที่เราจะได้รับในรายละเอียด ไปดูที่ splitpanedemo อื่น หรือถ้าคุณกำลังรีบคุณสามารถข้ามไปที่รายการของกฎ