SetScrollRange

ค่าต่ำสุด และสูงสุดตำแหน่งของแถบเลื่อนที่ระบุการตั้งค่าฟังก์ชันSetScrollRange.

ฟังก์ชันSetScrollRangeจะมีให้สำหรับความเข้ากันได้แบบย้อนหลัง โปรแกรมประยุกต์ใหม่ควรใช้ฟังก์ชันSetScrollInfo.

 (BOOL SetScrollRange HWND  hWnd, / / จัดการหน้าต่างด้วยแถบเลื่อนintnBar, / / เลื่อนแถบสถานะintnMinPos, / / ขั้นต่ำการเลื่อนตำแหน่งintnMaxPos, / / การเลื่อนตำแหน่งสูงสุดBOOLbRedraw / / ค่าสถานะการออกตั๋วใหม่);
 

พารามิเตอร์

hWnd
จัดการตัวควบคุมแถบเลื่อนหรือหน้าต่างที่ มีแถบเลื่อนมาตรฐาน ขึ้นอยู่กับค่าของพารามิเตอร์nBar.
nBar
ระบุแถบเลื่อนเพื่อตั้งค่า พารามิเตอร์นี้สามารถเป็นหนึ่งในค่าต่อไปนี้:
ค่า ความหมาย
SB_CTL กำหนดช่วงของตัวควบคุมแถบเลื่อน พารามิเตอร์hWndต้องเป็นหมายเลขอ้างอิงตัวควบคุมแถบเลื่อน.
SB_HORZ ตั้งค่าช่วงของแถบเลื่อนแนวนอนมาตรฐานของหน้าต่าง.
SB_VERT ตั้งค่าช่วงของแถบเลื่อนแนวตั้งมาตรฐานของหน้าต่าง.

nMinPos
ระบุอย่างน้อยการเลื่อนตำแหน่ง.
nMaxPos
ระบุการเลื่อนตำแหน่งสูงสุด.
bRedraw
ระบุว่า ควรจะวาดใหม่แถบเลื่อนเพื่อสะท้อนการเปลี่ยนแปลง ถ้าพารามิเตอร์นี้เป็น TRUE แถบเลื่อนจะวาดใหม่ ถ้าเป็น FALSE แถบเลื่อนไม่วาดใหม่.

ส่งกลับค่า

ถ้าฟังก์ชันสำเร็จ ค่าส่งกลับจะไม่ใช่ศูนย์.

ถ้าฟังก์ชันล้มเหลว ส่งคืนค่าเป็นศูนย์ การขอเพิ่มเติมข้อมูลข้อผิดพลาด โทร GetLastError.

หมายเหตุ

คุณสามารถใช้SetScrollRangeในการซ่อนแถบเลื่อน โดยการตั้งค่าnMinPosและnMaxPosเป็นค่าเดียวกัน แอปพลิเคชันไม่ควรเรียกใช้ฟังก์ชันSetScrollRangeเพื่อซ่อนแถบเลื่อนขณะประมวลผลข้อความแถบเลื่อน โปรแกรมประยุกต์ใหม่ควรใช้ฟังก์ชันShowScrollBarเพื่อซ่อนแถบเลื่อน.

ถ้าการเรียกไปยังSetScrollRangeทันทีการเรียกไปยังฟังก์ชันSetScrollPosพารามิเตอร์bRedrawในSetScrollPosต้องไม่เป็นศูนย์เมื่อต้องการป้องกันไม่ให้มีการวาดสองแถบเลื่อน.

ช่วงเวลาเริ่มต้นสำหรับแถบเลื่อนมาตรฐานคือ 0 ถึง 100 ช่วงเวลาเริ่มต้นสำหรับตัวควบคุมแถบเลื่อนที่ว่างเปล่า (ค่าพารามิเตอร์ทั้งnMinPosและnMaxPosเป็นศูนย์) ความแตกต่างระหว่างค่าที่ระบุ โดยพารามิเตอร์nMinPosและnMaxPosไม่ต้องมากกว่าค่าของ MAXLONG.

เนื่องจากข้อความที่ระบุว่า เลื่อนแถบตำแหน่ง WM_HSCROLL และ WM_VSCROLL ไม่จำกัด 16 บิตข้อมูลตำแหน่งงาน โปรแกรมประยุกต์ที่ใช้ข้อความเหล่านั้นสำหรับตำแหน่งข้อมูลมีค่าเป็นประโยชน์สูงสุดของ 65,535 สำหรับพารามิเตอร์nMaxPosของฟังก์ชันSetScrollRange.

อย่างไรก็ตาม เนื่องจากการSetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos, GetScrollRangeฟังก์ชัน และสนับสนุนข้อมูลตำแหน่งของแถบเลื่อน 32 บิต มีวิธีหลบหลีกสิ่งกีดขวาง 16 บิตของข้อความ WM_HSCROLL และ WM_VSCROLL ดูGetScrollInfoสำหรับคำอธิบายของเทคนิค.

QuickInfo

nbsp Windows &NT:ต้องการเวอร์ชัน 3.1 หรือรุ่นที่ใหม่กว่า
Windows:ต้องใช้ Windows 95 หรือรุ่นที่ใหม่กว่า
Windows CE:ต้องการรุ่น 2.0 หรือใหม่กว่า
หัวข้อ:ประกาศใน winuser.h
ไลบรารีที่นำเข้า:ใช้ user32.lib.

ดูเพิ่มเติม

ภาพรวมของแถบเลื่อนฟังก์ชันแถบเลื่อน GetScrollInfo, GetScrollPos, GetScrollRange, SetScrollInfo, SetScrollPos, ShowScrollBar

Index