מסוג ShowWindow

הפונקציה מסוג ShowWindow מגדיר מצב הצג החלון שצוין.

 (BOOL מסוג ShowWindow HWND  hWnd, / / לטפל לחלוןintnCmdShow / / הצגת המצב של חלון);
 

פרמטרים

hWnd
לטפל לחלון.
nCmdShow
מציין כיצד החלון הוא שיש להציג. פרמטר זה תקף בפעם הראשונה יישום הקורא מסוג ShowWindow, אם מספק תוכנית השיקה את היישום STARTUPINFO מבנה. אחרת, בפעם הראשונה שנקראת מסוג ShowWindow , הערך צריך להיות בערך שהתקבל על-ידי הפונקציה WinMain בפרמטר nCmdShow שלו. בקריאות העוקבות, פרמטר זה יכול להיות אחד מהבאים:
ערך משמעות
SW_FORCEMINIMIZE Windows NT 5.0 ואילך: מזעור חלון, גם אם הליך המשנה הנמצאים בבעלות החלון נתלה. דגל זה יש להשתמש רק בעת מזעור חלונות משנה אחר.
SW_HIDE מסתירה את החלון ומפעילה חלון אחר.
SW_MAXIMIZE הגדלת החלון שצוין.
SW_MINIMIZE ממזערת את החלון שצוין ומפעילה החלון הראשי הבא לפי סדר z.
SW_RESTORE מפעיל ומציג את החלון. אם החלון ממוזער או מוגדל, המערכת משחזר אותו לגודלו ולמיקומו המקוריים שלה. יישום, עליך לציין דגל זה בעת שחזור חלון ממוזער.
SW_SHOW מפעילה את החלון, ומציגה אותו הנוכחי בגודל ובמיקום שלו.
SW_SHOWDEFAULT ערכות המדינה הצג מבוסס על דגל SW_ המצוינים מבנה STARTUPINFO להעביר ל- CreateProcess פונקציה על-ידי התוכנית שהופעלה היישום.
SW_SHOWMAXIMIZED מפעילה את החלון, ומציגה אותו כחלון מוגדל.
SW_SHOWMINIMIZED מפעילה את החלון, ומציגה אותו בתור חלון ממוזער.
SW_SHOWMINNOACTIVE הצגת החלון כמו חלון ממוזער. החלון הפעיל נשארת פעילה.
SW_SHOWNA הצגת החלון במצבו הנוכחי. החלון הפעיל נשארת פעילה.
SW_SHOWNOACTIVATE הצגת חלון גודל ומיקום האחרונה שלו. החלון הפעיל נשארת פעילה.
SW_SHOWNORMAL הפעלת ומציגה חלון. אם החלון ממוזער או מוגדל, המערכת משחזר אותו לגודלו ולמיקומו המקוריים שלה. יישום יש לציין דגל זה בעת הצגת החלון בפעם הראשונה.

להחזיר ערכים

אם החלון היה גלוי בעבר, הערך המוחזר אינו אפס.

אם בעבר היה מוסתר של החלון, הערך המוחזר הוא אפס.

הערות

בפעם הראשונה שיישום הקורא מסוג ShowWindow, אותו יש להשתמש בפרמטר nCmdShow של הפונקציה WinMain כפרמטר nCmdShow שלו. התקשרויות עוקבות כדי מסוג ShowWindow עליך להשתמש באחד הערכים ברשימה נתונה, במקום שצוינה על-ידי הפרמטר nCmdShow של הפונקציה WinMain.

כאמור הדיון של הפרמטר nCmdShow , הערך nCmdShow מתעלמת בקריאה הראשונה כדי מסוג ShowWindow אם התוכנית בה מופעל היישום מציין מידע אתחול ב- STARTUPINFO מבנה. במקרה זה, מסוג ShowWindow משתמש במידע שצוין במבנה STARTUPINFO כדי להציג את החלון. על התקשרויות עוקבות, היישום חייב לקרוא מסוג ShowWindow עם nCmdShow מוגדר כ- SW_SHOWDEFAULT כדי להשתמש במידע האתחול המסופקים על-ידי התוכנית שבה השיקה את היישום. אופן פעולה זה מיועד עבור המצבים הבאים

חלונות CE: הפרמטר nCmdShow אינו תומך את הערכים הבאים

SW_MAXIMIZE

SW_MINIMIZE

SW_RESTORE

SW_SHOWDEFAULT

SW_SHOWMAXIMIZED

SW_SHOWMINIMIZED

SW_SHOWMINNOACTIVE

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.

ראה גם

מבט כולל על Windows, פונקציות חלון, ל- CreateProcess, של createwindow ליצירת, ShowOwnedPopups, STARTUPINFO, WinMain

Index