This snippet scrolls the picture wh

This snippet scrolls the picture whenever the user drags from the picture to a location outside the picture and pauses. The setAutoscrolls method is defined by JComponent for the purpose of assisting — but not implementing — scrolling by dragging. Setting the autoscrolls property to true makes the component fire synthetic mouse-dragged events even when the mouse isn't moving (because it stopped, mid-drag, outside the component). It's up to the component's mouse motion listener to listen for these events and react accordingly.

Sizing a Scroll Pane

Unless you explicitly set a scroll pane's preferred size, the scroll pane computes it based on the preferred size of its nine components (the viewport, and, if present, the two scroll bars, the row and column headers, and the four corners). The largest factor, and the one most programmers care about, is the size of the viewport used to display the client.

If the client is not scrolling-savvy, then the scroll pane sizes itself so that the client displays at its preferred size. For typical unsavvy clients, this makes the scroll pane redundant. That is, the scroll pane has no scroll bars because the client's preferred size is big enough to display the entire client. In this case, if the client doesn't change size dynamically, you should probably limit the size of the scroll pane by setting its preferred size or the preferred size of its container.

If the client is scrolling-savvy, then the scroll pane uses the value returned by the client's getPreferredScrollableViewportSize method to compute the size of its viewport. Implementations of this method generally report a preferred size for scrolling that's smaller than the component's standard preferred size. For example, by default, the value returned by JList's implementation of getPreferredScrollableViewportSize is just big enough to display eight rows.

Scrolling-savvy classes, like lists, tables, text components, and trees, often provide one or more methods that let programmers affect the size returned from getPreferredScrollableViewportSize. For example, you can set the number of visible rows in a list or a tree by calling the setVisibleRowCount method. The list or tree takes care of figuring out the size needed to display that number of rows.

Refer to Methods in Other Classes Related to Scrolling for information about scrolling-related methods provided by classes other than JScrollPane. And remember — if you don't like the value that getPreferredScrollableViewportSize returns, you can always set the preferred size of the scroll pane or its container.

Dynamically Changing the Client's Size

Changing the size of a scroll pane's client is a two-step process. First, set the client's preferred size. Then, call revalidate on the client to let the scroll pane know that it should update itself and its scroll bars. Let's look at an example.

Here's a picture of an application that changes the client's size whenever the user places a circle whose bounds fall outside of the client's current bounds. The program also changes the client's size when the user clears the drawing area:

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

ส่วนย่อยของโค้ดนี้เลื่อนรูปภาพเมื่อผู้ใช้ลากจากภาพไปยังตำแหน่งภายนอกภาพและหยุดชั่วคราว วิธี setAutoscrolls ถูกกำหนด โดย JComponent เพื่อให้ความช่วยเหลือ — แต่ไม่ใช้ — เลื่อนลาก ตั้งค่าคุณสมบัติ autoscrolls ในการทำให้เป็นจริงประกอบไฟสังเคราะห์เมาส์ลากเหตุการณ์แม้ไม่มีการเคลื่อนย้ายเมาส์ (เพราะมันหยุด ลากกลาง ภายนอกส่วนประกอบ) มันขึ้นอยู่กับส่วนประกอบของเมาส์เคลื่อนไหวฟังฟังเหตุการณ์เหล่านี้ และตอบสนองตามการปรับขนาดของบานเลื่อนยกเว้นว่าคุณอย่างชัดเจนตั้งขนาดต้องเป็นบานเลื่อน บานเลื่อนจะได้ตามขนาดที่ต้องการประกอบเก้า (viewport และ ถ้ามี ทั้งสองเลื่อนบาร์ ส่วนหัวของแถวและคอลัมน์ และสี่มุม) ตัวที่ใหญ่ที่สุด และหนึ่งส่วนใหญ่โปรแกรมเมอร์ดูแลเกี่ยวกับ ขนาดของช่องมุมมองผู้ใช้ไคลเอ็นต์ถ้าไคลเอ็นต์ไม่ได้เลื่อนเข้าใจ แล้วบานเลื่อนขนาดตัวเองเพื่อให้ไคลเอ็นต์แสดงขนาดที่ต้องการ สำหรับลูกค้า unsavvy ทั่วไป ทำบานเลื่อนซ้ำ นั่นคือ บานเลื่อนมีแถบเลื่อนไม่ได้เนื่องจากขนาดที่ต้องการของลูกค้ามีขนาดใหญ่พอที่จะแสดงลูกค้าทั้งหมด ในกรณีนี้ ถ้าไคลเอ็นต์ไม่เปลี่ยนขนาดแบบไดนามิก คุณควรอาจจำกัดขนาดของบานเลื่อน โดยการกำหนดขนาดที่ต้องการหรือขนาดที่ต้องการของสิ่งที่บรรจุถ้าลูกค้าเข้าใจเลื่อน บานเลื่อนใช้ค่าที่ส่งกลับ โดยวิธี getPreferredScrollableViewportSize ของไคลเอนต์เพื่อคำนวณขนาดของช่องมุมมองของการ ปฏิบัติการของวิธีนี้โดยทั่วไปรายงานขนาดที่ต้องการสำหรับเลื่อนที่มีขนาดเล็กกว่าขนาดที่ต้องการมาตรฐานของส่วนประกอบ ตัวอย่าง เริ่มต้น ค่าที่ได้จากงานของ JList getPreferredScrollableViewportSize ได้เพียงขนาดใหญ่พอจะแสดงแถวที่ 8เข้าใจเลื่อนชั้น รายการ ตาราง ส่วนประกอบข้อความ ต้นไม้ และมักจะมีวิธี หนึ่งที่ช่วยให้โปรแกรมเมอร์ที่มีผลต่อขนาดที่ส่งคืนจาก getPreferredScrollableViewportSize ตัวอย่าง คุณสามารถตั้งจำนวนแถวที่เห็นในรายการหรือต้นไม้ โดยการเรียกวิธี setVisibleRowCount รายการหรือแผนภูมิดูแลหาขนาดที่จำเป็นเพื่อแสดงจำนวนแถวที่ถึงวิธีอื่น ๆ ชั้นที่เกี่ยวข้องกับ Scrolling สำหรับข้อมูลเกี่ยวกับวิธีการเลื่อนที่เกี่ยวข้องสำหรับผู้เรียนนอกเหนือจาก JScrollPane และจำ — ถ้าคุณไม่ชอบค่า getPreferredScrollableViewportSize ที่ส่งกลับ คุณจะสามารถตั้งขนาดของบานเลื่อนหรือภาชนะที่ต้องการการเปลี่ยนแปลงขนาดของไคลเอนต์แบบไดนามิกการเปลี่ยนขนาดของบานเลื่อนลูกค้าเป็นกระบวนการสองขั้นตอน ครั้งแรก ได้ขนาดที่ต้องการของลูกค้า แล้ว เรียก revalidate บนไคลเอนต์เพื่อให้บานเลื่อนที่รู้ว่า มันควรปรับปรุงตัวเองและของแถบเลื่อน ลองดูตัวอย่างนี่คือภาพของแอพลิเคชันที่เปลี่ยนแปลงขนาดของลูกค้าเมื่อใดก็ ตามผู้ใช้เป็นวงกลมที่มีขอบเขตอยู่ภายนอกขอบเขตปัจจุบันของไคลเอ็นต์ โปรแกรมจะเปลี่ยนขนาดของไคลเอ็นต์เมื่อผู้ล้างพื้นที่วาดรูป:

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

ตัวอย่างนี้เลื่อนภาพเมื่อใดก็ตามที่ผู้ใช้ลากจากภาพไปยังสถานที่นอกภาพและการหยุด วิธี setAutoscrolls ถูกกำหนดโดย JComponent เพื่อวัตถุประสงค์ในการให้ความช่วยเหลือ - แต่ไม่ดำเนินการ - โดยการลากเลื่อน ตั้งค่าคุณสมบัติ autoscrolls จริงทำให้องค์ประกอบไฟเหตุการณ์เมาส์ลากสังเคราะห์แม้ในขณะที่เมาส์จะไม่ย้าย (เพราะมันหยุดกลางลากนอกส่วนประกอบ) มันขึ้นอยู่กับเมาส์ส่วนประกอบฟังการเคลื่อนไหวในการฟังสำหรับเหตุการณ์เหล่านี้และตอบสนองตาม. ขนาดเลื่อนบานหน้าต่างจนกว่าคุณอย่างชัดเจนกำหนดขนาดที่ต้องการบานหน้าต่างเลื่อนบานเลื่อนคำนวณมันขึ้นอยู่กับขนาดที่ต้องการของเก้าส่วนประกอบ (วิวพอร์ตและ ถ้ามีสองแถบเลื่อนแถวและส่วนหัวคอลัมน์และมุมทั้งสี่) ปัจจัยที่ใหญ่ที่สุดและเป็นคนโปรแกรมเมอร์ส่วนใหญ่เกี่ยวกับการดูแลเป็นขนาดของ viewport ที่ใช้เพื่อแสดงลูกค้า. หากลูกค้าไม่ได้รับการเลื่อนเข้าใจแล้วขนาดบานหน้าต่างเลื่อนตัวเองเพื่อให้การแสดงลูกค้าที่ขนาดที่ต้องการ สำหรับลูกค้าทั่วไป unsavvy นี้ทำให้บานหน้าต่างเลื่อนซ้ำซ้อน นั่นคือบานหน้าต่างเลื่อนไม่มีแถบเลื่อนเพราะขนาดที่ต้องการของลูกค้าที่มีขนาดใหญ่พอที่จะแสดงไคลเอ็นต์ทั้งหมด ในกรณีนี้ถ้าลูกค้าไม่ได้เปลี่ยนขนาดแบบไดนามิกคุณอาจจะ จำกัด ขนาดของบานหน้าต่างเลื่อนโดยการตั้งค่าขนาดที่ต้องการหรือขนาดที่ต้องการของภาชนะ. หากลูกค้ามีการเลื่อนเข้าใจแล้วใช้เลื่อนบานหน้าต่าง ค่าส่งกลับโดยวิธี getPreferredScrollableViewportSize ของลูกค้าในการคำนวณขนาดของ viewport ของตน การดําเนินการของวิธีการนี้โดยทั่วไปรายงานขนาดที่ต้องการสำหรับการเลื่อนที่มีขนาดเล็กกว่าองค์ประกอบมาตรฐานขนาดที่ต้องการ ตัวอย่างเช่นโดยค่าเริ่มต้นค่าส่งกลับโดยการดำเนินการ JList ของ getPreferredScrollableViewportSize เป็นเพียงใหญ่พอที่จะแสดงแปดแถว. เรียนเลื่อนเข้าใจเช่นรายการตารางส่วนประกอบข้อความและต้นไม้มักจะให้วิธีการหนึ่งหรือมากกว่าหนึ่งที่ช่วยให้โปรแกรมเมอร์ส่งผลกระทบต่อ ขนาดกลับมาจาก getPreferredScrollableViewportSize ตัวอย่างเช่นคุณสามารถตั้งค่าจำนวนแถวมองเห็นได้ในรายการหรือต้นไม้โดยเรียกวิธี setVisibleRowCount รายการหรือต้นไม้ดูแลของการหาขนาดที่จำเป็นในการแสดงจำนวนแถวที่. อ้างถึงวิธีการในการเรียนการสอนอื่น ๆ ที่เกี่ยวข้องกับการเลื่อนสำหรับข้อมูลเกี่ยวกับวิธีการเลื่อนที่เกี่ยวข้องกับการให้บริการโดยชั้นเรียนอื่น ๆ กว่า JScrollPane และจำไว้ว่า - ถ้าคุณไม่ชอบค่าที่ getPreferredScrollableViewportSize ผลตอบแทนคุณสามารถตั้งค่าเสมอขนาดที่ต้องการของบานหน้าต่างเลื่อนหรือภาชนะ. แบบไดนามิกการเปลี่ยนขนาดของลูกค้าเปลี่ยนขนาดของลูกค้าของบานหน้าต่างเลื่อนที่เป็นกระบวนการที่สองขั้นตอน ขั้นแรกให้กำหนดขนาดที่ต้องการของลูกค้า จากนั้นเรียก revalidate กับลูกค้าที่จะให้เลื่อนบานหน้าต่างรู้ว่ามันควรจะปรับปรุงตัวเองและของแถบเลื่อน ลองดูที่ตัวอย่าง. นี่คือภาพของแอพลิเคชันที่มีการเปลี่ยนแปลงขนาดของลูกค้าเมื่อใดก็ตามที่ผู้ใช้สถานที่วงกลมที่มีขอบเขตอยู่นอกขอบเขตปัจจุบันลูกค้า โปรแกรมนี้ยังมีการเปลี่ยนแปลงขนาดของลูกค้าเมื่อผู้ใช้ล้างพื้นที่วาดภาพ:

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

ตัวอย่างนี้เป็นภาพเมื่อผู้ใช้ลากจากภาพไปยังสถานที่นอกภาพ และการหยุด setautoscrolls วิธีที่กำหนดโดย jcomponent เพื่อช่วย - แต่ไม่ได้ใช้ - เลื่อนโดยการลากการตั้งค่า autoscrolls คุณสมบัติที่แท้จริงทำให้องค์ประกอบไฟสังเคราะห์เมาส์ลากเหตุการณ์เมื่อเมาส์ไม่ขยับ ( เพราะมันหยุดกลางลากนอกคอม ) มันขึ้นอยู่กับองค์ประกอบของเมาส์เคลื่อนไหวฟังเหตุการณ์เหล่านี้และตอบสนองตาม

ขนาดเลื่อนบานหน้าต่าง

ถ้าคุณอย่างชัดเจนกำหนดเลื่อนบานหน้าต่างที่ต้องการขนาดวันเลื่อนบานหน้าต่างที่คำนวณได้ตามขนาดที่ต้องการของเก้าส่วนประกอบ ( viewport และถ้าปัจจุบันสองแถบเลื่อนแถว และส่วนหัวของคอลัมน์และสี่มุม ) ปัจจัยที่ใหญ่ที่สุดและหนึ่งในโปรแกรมเมอร์ส่วนใหญ่สนใจ คือ ขนาดของ Viewport ที่ใช้แสดงกับลูกค้า

ถ้าลูกค้าไม่ได้ถูกเลื่อน ชาญแล้วเลื่อนบานหน้าต่างขนาดตัวเองเพื่อให้ลูกค้าที่ต้องการแสดงขนาดของ สำหรับลูกค้า unsavvy ทั่วไป ทำให้เลื่อนบานหน้าต่าง ) นั่นคือ เลื่อนบานหน้าต่างไม่มีแถบเลื่อน เพราะลูกค้าที่ต้องการมีขนาดใหญ่พอที่จะแสดงลูกค้าทั้งหมด ในกรณีนี้ หากลูกค้าไม่ได้เปลี่ยนขนาดแบบไดนามิก ,คุณอาจจะ จำกัด ขนาดของบานหน้าต่างเลื่อนโดยการตั้งค่าขนาดที่ต้องการหรือขนาดที่ต้องการของภาชนะ .

หากลูกค้ามีการเลื่อนชาญ จากนั้นเลื่อนบานหน้าต่างใช้ค่าที่ส่งกลับโดยวิธี getpreferredscrollableviewportsize ของลูกค้า คำนวณหาขนาดของ Viewport .ใช้วิธีนี้โดยทั่วไปรายงานขนาดที่ต้องการสำหรับการเลื่อนมันเล็กกว่าของชิ้นส่วนมาตรฐานที่ต้องการขนาด ตัวอย่างเช่น โดยค่าเริ่มต้น ค่าคืนของการ jlist getpreferredscrollableviewportsize เป็นเพียงขนาดใหญ่พอที่จะแสดงแปดแถว

เลื่อนคลาส ชาญ เช่น รายการ , ตาราง , ส่วนประกอบ , ข้อความ และต้นไม้มักจะมีหนึ่งหรือมากกว่าหนึ่งวิธีที่ช่วยให้โปรแกรมเมอร์มีผลต่อขนาดกลับมาจาก getpreferredscrollableviewportsize . ตัวอย่างเช่นคุณสามารถตั้งค่าจำนวนของแถวที่มองเห็นได้ในรายการ หรือต้นไม้ โดยเรียกวิธีการ setvisiblerowcount . รายชื่อต้นไม้ดูแลหาขนาดที่ต้องการให้แสดงหมายเลขของแถว

ดูวิธีการในชั้นเรียนอื่น ๆที่เกี่ยวข้องกับการเลื่อน สำหรับข้อมูลเกี่ยวกับวิธีการอื่น ๆที่เกี่ยวข้อง โดยการเลื่อนชั้นเรียนกว่า jscrollpane . และจำไว้ว่า ถ้าคุณไม่ชอบ getpreferredscrollableviewportsize ส่งกลับค่าที่คุณสามารถตั้งค่าขนาดที่ต้องการเลื่อนบานหน้าต่างหรือคอนเทนเนอร์ของ



แบบไดนามิกเปลี่ยนขนาดของลูกค้าการเปลี่ยนขนาดเลื่อนบานหน้าต่างของลูกค้าเป็นกระบวนการสองขั้นตอน แรก , ชุดของลูกค้าที่ต้องการขนาด งั้นเรียก revalidate ที่ลูกค้าขอเลื่อนบานหน้าต่างรู้ว่าควรปรับปรุงตัวเองและแถบเลื่อนของ ลองดูที่ตัวอย่าง

นี่คือรูปของโปรแกรมที่มีการเปลี่ยนแปลงขนาดของลูกค้าเมื่อใดก็ตามที่ผู้ใช้สถานที่วงกลมที่มีขอบเขตอยู่ภายนอกขอบเขตของลูกค้าในปัจจุบัน โปรแกรมมีการเปลี่ยนแปลงขนาดของลูกค้าเมื่อผู้ใช้ล้างบริเวณที่เขียน :