SetScrollPos

ฟังก์ชันSetScrollPosการตั้งค่าตำแหน่งของกล่องเลื่อน (นิ้วหัวแม่มือ) ในแถบเลื่อนที่ระบุ และ ถ้าร้องขอ redraws แถบเลื่อนเพื่อแสดงตำแหน่งใหม่ของกล่องเลื่อน.

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

int SetScrollPos ( HWND  hWnd, / / จัดการหน้าต่างด้วยแถบเลื่อนintnBar, / / เลื่อนแถบสถานะintnPos, / / new ตำแหน่งของกล่องเลื่อนBOOLbRedraw / / ค่าสถานะการออกตั๋วใหม่);
 

พารามิเตอร์

hWnd

จัดการตัวควบคุมแถบเลื่อนหรือหน้าต่างที่ มีแถบเลื่อนมาตรฐาน ขึ้นอยู่กับค่าของพารามิเตอร์nBar.

nBar

ระบุแถบเลื่อนเพื่อตั้งค่า พารามิเตอร์นี้สามารถเป็นหนึ่งในค่าต่อไปนี้:

ค่า	ความหมาย
SB_CTL	ตั้งค่าตำแหน่งของกล่องเลื่อนในตัวควบคุมแถบเลื่อน พารามิเตอร์hWndต้องเป็นหมายเลขอ้างอิงตัวควบคุมแถบเลื่อน.
SB_HORZ	การตั้งค่าตำแหน่งของกล่องเลื่อนแถบเลื่อนแนวนอนมาตรฐานของหน้าต่าง.
SB_VERT	การตั้งค่าตำแหน่งของกล่องเลื่อนแถบเลื่อนแนวตั้งมาตรฐานของหน้าต่าง.

nPos

ระบุตำแหน่งใหม่ของกล่องเลื่อน ตำแหน่งงานที่ต้องอยู่ภายในช่วงเลื่อน สำหรับข้อมูลเพิ่มเติมเกี่ยวกับช่วงเลื่อน ดูฟังก์ชันSetScrollRange.

bRedraw

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

ส่งกลับค่า

ถ้าฟังก์ชันสำเร็จ ค่าส่งกลับเป็นตำแหน่งก่อนหน้าของกล่องเลื่อน.

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

หมายเหตุ

การตั้งค่าพารามิเตอร์bRedrawเป็น FALSE จะเป็นประโยชน์หากมีการวาดใหม่แถบเลื่อน โดยการเรียกฟังก์ชันอื่นตามมา.

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

อย่างไรก็ตาม เนื่องจากการ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, SetScrollRange

Index