ExtractIconEx

ฟังก์ชันExtractIconExสร้างอาร์เรย์ของที่จับการขยายจากแฟ้มที่ปฏิบัติการได้ระบุ dynamic-link library (DLL), หรือไอคอนแฟ้มไอคอนขนาดเล็ก หรือขนาดใหญ่.

(UINT ExtractIconEx LPCTSTR  lpszFile, int  nIconIndex, HICON ไกล * phiconLarge, HICON ไกล * phiconSmall, UINT  nIcons);
 

พารามิเตอร์

lpszFile
ชี้ให้ระบุชื่อของแฟ้มที่ปฏิบัติการได้ DLL หรือไอคอนแฟ้มที่ไอคอนจะถูกแยกเป็นสตริงสิ้นสุดด้วยค่า null.
nIconIndex
ระบุดัชนีของไอคอนตัวแรกเพื่อแยก zero-based ตัวอย่างเช่น ถ้าค่านี้เป็นศูนย์ ฟังก์ชันแยกไอคอนตัวแรกในแฟ้มที่ระบุ.

ถ้าค่านี้คือ – 1 และphIconLargeและphiconSmallทั้งสองค่า NULL ฟังก์ชันจะส่งกลับจำนวนของไอคอนในแฟ้มที่ระบุ ถ้าแฟ้มเป็นแฟ้มกระทำการหรือ DLL ค่าส่งกลับมีหมายเลขของทรัพยากร RT_GROUP_ICON ถ้าแฟ้มไม่มีICO แฟ้ม ส่งคืนค่าเป็น 1.

Windows 95, Windows NT 4.0 และรุ่นที่ใหม่กว่า: ถ้าค่านี้เป็นตัวเลขที่เป็นค่าลบ และเป็นphIconLargeหรือphiconSmallไม่ใช่ NULL ฟังก์ชันเริ่มต้น ด้วยการแยกไอคอนเป็นตัวระบุทรัพยากรซึ่งเท่ากับค่าสัมบูรณ์ของnIconIndex ตัวอย่าง ใช้ -3 แยกไอคอนที่มีตัวระบุทรัพยากรคือ 3.

phiconLarge
ชี้ไปยังอาร์เรย์ของไอคอนจับซึ่งได้รับของที่จับการขยายจากแฟ้มไอคอนขนาดใหญ่ ถ้าพารามิเตอร์นี้เป็นค่า NULL ไม่มีไอคอนขนาดใหญ่จะถูกแยกจากแฟ้ม.
phiconSmall
ชี้ไปยังอาร์เรย์ของไอคอนจับซึ่งได้รับของที่จับการขยายจากแฟ้มไอคอนขนาดเล็ก ถ้าพารามิเตอร์นี้เป็นค่า NULL ไม่มีไอคอนขนาดเล็กจะถูกแยกจากแฟ้ม.
nIcons
ระบุจำนวนของไอคอนการแยกออกจากแฟ้ม.

ส่งกลับค่า

ถ้าพารามิเตอร์nIconIndex -1 พารามิเตอร์phiconLargeเป็น NULL และพารามิเตอร์phiconSmallเป็น NULL แล้วส่งคืนค่าเป็นจำนวนไอคอนที่มีอยู่ในแฟ้มที่ระบุ มิฉะนั้น ค่าส่งกลับเป็นจำนวนไอคอนที่แยกจากแฟ้มเรียบร้อยแล้ว.

หมายเหตุ

คุณต้องทำลายไอคอนทั้งหมดแยกตามExtractIconExโดยการเรียกฟังก์ชันDestroyIcon.

เมื่อต้องการเรียกใช้ ขนาดของไอคอนขนาดใหญ่ และขนาดเล็กใช้ GetSystemMetricsฟังก์ชันกับค่าสถานะ SM_CXICON, SM_CYICON, SM_CXSMICON และ SM_CYSMICON.

Windows CE: พารามิเตอร์nIconIndexต้องเป็นศูนย์หรือ –N โดยที่ N คือ ตัวระบุทรัพยากรที่ระบุ พารามิเตอร์nIconsต้องเป็น 1.

QuickInfo

nbsp Windows &NT:ต้องการรุ่น 3.5 หรือรุ่นที่ใหม่กว่า
Windows:ต้องใช้ Windows 95 หรือรุ่นที่ใหม่กว่า
Windows CE:ต้องการเวอร์ชัน 1.0 หรือรุ่นใหม่กว่า
หัวข้อ:ประกาศใน shellapi.h
ไลบรารีที่นำเข้า:ใช้ shell32.lib
Unicode:นำมาใช้เป็น Unicode และ ANSI รุ่นบน Windows NT.

ดูเพิ่มเติม

รวมไอคอนไอคอนฟังก์ชัน DestroyIcon, ExtractIcon

Index