MessageBoxEx

MessageBoxEx funkcia vytvára, zobrazuje a prevádzkuje okno s hlásením. V okne s hlásením obsahuje hlásenie definovanom aplikáciou a hlava plus ľubovoľnú kombináciu preddefinované ikony a tlačítka. WLanguageId parameter určuje, ktorý súbor jazykových zdrojov sa používa na preddefinované tlačítka. Opisy ďalších parametrov MessageBoxExzobraziť okno s hlásením.

int MessageBoxEx ( HWND  hWnd; / / zvládnuť vlastník oknoLPCTSTRlpText; / / address text v okne hláseniaLPCTSTRlpCaption; / / address hlavy okno s hlásenímUINTuType; / / štýl okna hláseniaProgram WORDwLanguageId / / identifikátor jazyka);

Parametre

hWnd

Identifikuje vlastníka okno s hlásením sa vytvorí. Ak má tento parameter hodnotu NULL, v okne s hlásením nemá vlastníka okna.

lpCaption

Smerník na reťazec zakončený obsahujúce správy sa zobrazí.

lpszTitle

Smerník na reťazec zakončený slúžiacich pre dialógové okno pole titul. Ak má tento parameter hodnotu NULL, používa sa predvolený názov chyba.

uType

Určuje množinu bitové príznaky, ktoré určujú obsah a správanie v dialógovom okne. Tento parameter môže byť kombináciou vlajok z nasledujúcich skupín vlajky.

Určiť jednu z nasledujúcich príznakov označovať tlačidlá obsiahnuté v okne s hlásením:

Vlajka Význam

MB_ABORTRETRYIGNORE V okne s hlásením obsahuje tri tlačítka: zrušiť, znova, a ignorovať.

MB_OK V okne s hlásením obsahuje jedno tlačidlo push: OK. Táto možnosť je predvolená.

MB_OKCANCEL V okne s hlásením obsahuje dve tlačítka: OK a zrušiť.

MB_RETRYCANCEL V okne s hlásením obsahuje dve tlačítka: znova a zrušiť.

MB_YESNO V okne s hlásením obsahuje dve tlačítka: Áno a nie.

MB_YESNOCANCEL V okne s hlásením obsahuje tri tlačítka: áno, nie a zrušiť.

Vlajka	Význam
MB_ABORTRETRYIGNORE	V okne s hlásením obsahuje tri tlačítka: zrušiť, znova, a ignorovať.
MB_OK	V okne s hlásením obsahuje jedno tlačidlo push: OK. Táto možnosť je predvolená.
MB_OKCANCEL	V okne s hlásením obsahuje dve tlačítka: OK a zrušiť.
MB_RETRYCANCEL	V okne s hlásením obsahuje dve tlačítka: znova a zrušiť.
MB_YESNO	V okne s hlásením obsahuje dve tlačítka: Áno a nie.
MB_YESNOCANCEL	V okne s hlásením obsahuje tri tlačítka: áno, nie a zrušiť.

Zadajte jeden z nasledovných príznakov sa ikona zobrazí v okne s hlásením:

Vlajka Význam

MB_ICONEXCLAMATION,
MB_ICONWARNING
V okne s hlásením sa zobrazí ikona výkričník.

MB_ICONINFORMATION, MB_ICONASTERISK
V okne s hlásením sa zobrazí ikona pozostávajúce z malé písmeno som v kruhu.

MB_ICONQUESTION Otáznik ikona zobrazí v okne s hlásením.

MB_ICONSTOP,
MB_ICONERROR,
MB_ICONHAND
Zastávky podpísať ikona zobrazí v okne s hlásením.

Vlajka	Význam
MB_ICONEXCLAMATION, MB_ICONWARNING	V okne s hlásením sa zobrazí ikona výkričník.
MB_ICONINFORMATION, MB_ICONASTERISK	V okne s hlásením sa zobrazí ikona pozostávajúce z malé písmeno som v kruhu.
MB_ICONQUESTION	Otáznik ikona zobrazí v okne s hlásením.
MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND	Zastávky podpísať ikona zobrazí v okne s hlásením.

Zadajte jeden z nasledovných príznakov označovať predvolené tlačidlo:

Vlajka Význam

MB_DEFBUTTON1 Prvé tlačidlo je predvoleným tlačidlom.
MB_DEFBUTTON1 je predvolené nastavenie, pokiaľ nie je špecifikované MB_DEFBUTTON2, MB_DEFBUTTON3 alebo MB_DEFBUTTON4.

MB_DEFBUTTON2 Druhé tlačidlo je predvoleným tlačidlom.

MB_DEFBUTTON3 Tretie tlačidlo je predvoleným tlačidlom.

MB_DEFBUTTON4 Štvrté tlačidlo je predvoleným tlačidlom.

Vlajka	Význam
MB_DEFBUTTON1	Prvé tlačidlo je predvoleným tlačidlom. MB_DEFBUTTON1 je predvolené nastavenie, pokiaľ nie je špecifikované MB_DEFBUTTON2, MB_DEFBUTTON3 alebo MB_DEFBUTTON4.
MB_DEFBUTTON2	Druhé tlačidlo je predvoleným tlačidlom.
MB_DEFBUTTON3	Tretie tlačidlo je predvoleným tlačidlom.
MB_DEFBUTTON4	Štvrté tlačidlo je predvoleným tlačidlom.

Zadajte jeden zo nasledovné príznaky označujú modalita dialógového okna:

Vlajka Význam

MB_APPLMODAL Používateľ musí odpovedať v okne s hlásením pred pokračovaním práce v okne identifikovaný parametrom hWnd . Však používateľ môže presťahovať windows ostatným vláknam a pracovať v týchto oknách.
V závislosti od hierarchie windows v aplikácii používateľ môže byť schopný prejsť do iného okna v rámci vlákno. Všetky podriadené okná materskej spoločnosti v okne s hlásením sa automaticky vypnú, ale nie sú popup okien.

MB_APPLMODAL je predvolené, ak je určený ani MB_SYSTEMMODAL, ani MB_TASKMODAL.

MB_SYSTEMMODAL Rovnaké ako MB_APPLMODAL, s výnimkou toho, že v okne s hlásením WS_EX_TOPMOST štýlu. Pomocou systému modalu hláseniami informovať používateľa o vážne, potenciálne škodlivý vplyv chyby, ktoré si vyžadujú okamžitú pozornosť (napríklad nedostatok pamäte). Táto vlajka nemá žiadny vplyv na používateľa schopnosť komunikovať s okien iných ako tie, ktoré súvisia s hWnd.

MB_TASKMODAL Rovnaké ako MB_APPLMODAL, okrem toho, že všetky najvyššej úrovne systému windows patriaci do aktuálne vlákno sú neaktívne, ak hWnd parameter hodnotu NULL. Použiť tento príznak, ak volajúci žiadosti alebo knižnica nemá rukoväť okno k dispozícii, ale stále existuje potreba zabrániť vstupu do iných oknách volajúci vlákno bez zrušenia ostatným vláknam.

Vlajka	Význam
MB_APPLMODAL	Používateľ musí odpovedať v okne s hlásením pred pokračovaním práce v okne identifikovaný parametrom hWnd . Však používateľ môže presťahovať windows ostatným vláknam a pracovať v týchto oknách. V závislosti od hierarchie windows v aplikácii používateľ môže byť schopný prejsť do iného okna v rámci vlákno. Všetky podriadené okná materskej spoločnosti v okne s hlásením sa automaticky vypnú, ale nie sú popup okien. MB_APPLMODAL je predvolené, ak je určený ani MB_SYSTEMMODAL, ani MB_TASKMODAL.
MB_SYSTEMMODAL	Rovnaké ako MB_APPLMODAL, s výnimkou toho, že v okne s hlásením WS_EX_TOPMOST štýlu. Pomocou systému modalu hláseniami informovať používateľa o vážne, potenciálne škodlivý vplyv chyby, ktoré si vyžadujú okamžitú pozornosť (napríklad nedostatok pamäte). Táto vlajka nemá žiadny vplyv na používateľa schopnosť komunikovať s okien iných ako tie, ktoré súvisia s hWnd.
MB_TASKMODAL	Rovnaké ako MB_APPLMODAL, okrem toho, že všetky najvyššej úrovne systému windows patriaci do aktuálne vlákno sú neaktívne, ak hWnd parameter hodnotu NULL. Použiť tento príznak, ak volajúci žiadosti alebo knižnica nemá rukoväť okno k dispozícii, ale stále existuje potreba zabrániť vstupu do iných oknách volajúci vlákno bez zrušenia ostatným vláknam.

Okrem toho môžete zadať nasledovné príznaky:

MB_DEFAULT_DESKTOP_ONLY

Pracovnej ploche v súčasnosti prijímaním vstupu musí byť predvolenej pracovnej ploche; v opačnom prípade funkcia zlyhá. Predvolené ploche je jedna aplikácia beží na po používateľ je prihlásený.

MB_HELP

Pridá tlačidlo Pomocníka v okne s hlásením. Výberom tlačidlo Pomocník alebo stlačením klávesu F1 vytvára Pomocníka udalosti.

MB_RIGHT

Text je zarovnaná doprava.

MB_RTLREADING

Zobrazí hlásenie a popis text pomocou čítania sprava doľava v hebrejčine a arabčine systémoch.

MB_SETFOREGROUND

V okne s hlásením sa stáva popredia okna. Interne, systém zavolá funkciu SetForegroundWindow pre okno s hlásením.

MB_TOPMOST

V okne s hlásením sa vytvorí štýlom WS_EX_TOPMOST okno.

MB_SERVICE_NOTIFICATION

Systém Windows NT: Volajúci je služba oznamujúce používateľa udalosť. Funkciu zobrazí okno s hlásením na aktuálne súčasť active desktop, aj keď tam je žiaden používateľa prihláseného na počítač.

Ak tento vlajky je nastavený hWnd parameter musí byť NULL. To je tak v okne s hlásením sa môže zobraziť na pracovnej ploche iné, než plochy zodpovedajúce hWnd.

Pre systém Windows NT verzia 4.0 sa zmenil hodnotu MB_SERVICE_NOTIFICATION. Pozri WINUSER.H pre staré a nové hodnoty. Systém Windows NT 4.0 poskytuje spätnú kompatibilitu pre existujúce služby priradením Star+í hodnota novú hodnotu pri vykonávaní okno s hlásením a MessageBoxEx. Toto priradenie je urobiť iba pre spúšťateľné súbory, ktoré majú číslo verzie, ako nastaviť prepojovacím, menej ako 4.0.

Vybudovať služba, ktorá využíva MB_SERVICE_NOTIFICATION a môžu jazdiť na 3.x systému Windows NT a Windows NT 4.0, máte dve možnosti.

V čase prepojenia zadajte číslo verzie nižšia ako 4.0; alebo

nbsp; 2. V čase prepojenia, určiť verzia 4.0. V run-time, použite GetVersionEx funkciu skontrolovať verziu systému. Potom, keď beží na Windows &NT 3.x, použite MB_SERVICE_NOTIFICATION_NT3X; a v systéme Windows NT 4.0, použite MB_SERVICE_NOTIFICATION.

MB_SERVICE_NOTIFICATION_NT3X

Systém Windows NT: Táto hodnota zodpovedá hodnote definovaných pre MB_SERVICE_NOTIFICATION pre systém Windows NT verzie 3.51.

wLanguageId

Určuje jazyk, v ktorom chcete zobraziť text obsiahnutý v preddefinovaných tlačítka. Táto hodnota musí byť vo forme odoslal

MAKELANGID makro.

Zoznam podporovaných programátorom Win32 identifikátoroch jazyka nájdete v časti Identifikátoroch jazyka. Všimnite si, že každá lokalizovaná verzia systému Windows a systém Windows NT zvyčajne obsahuje zdroje len pre obmedzený počet jazykov. Preto napríklad verziu USA ponúka LANG_ENGLISH, francúzskej verzii ponúka LANG_FRENCH, nemecká verzia ponúka LANG_GERMAN a japonská verzia ponúka LANG_JAPANESE. Každá verzia ponúka LANG_NEUTRAL. Týmto obmedzíte množinu hodnôt, ktoré môžete použiť s parametrom wLanguageId . Pred uvedením identifikátor jazyka, by mali vykonať enumeráciu miestne nastavenia, ktoré sú nainštalované v systéme.

Note:

Ak funkciu podarí, vrátená hodnota je nenulové položka ponuky hodnoty vrátené dialógového okna.

Hodnota	Význam
IDABORT	Prerušenie tlačidlo bol vybraný.
IDCANCEL	Tlačidlo Zrušiť bol vybraný.
IDIGNORE	Ignorovať vybraté tlačidlo.
IDNO	Žiadne tlačidlo bol vybraný.
IDOK	Tlačidla OK bol vybraný.
IDRETRY	Bolo vybraté tlačidlo znova.
IDYES	Áno bolo vybraté tlačidlo.

Ak okno s hlásením na tlačidlo Zrušiť, funkcia vráti hodnotu IDCANCEL, po stlačení klávesu esc alebo tlačidlo Zrušiť. Ak v okne s hlásením nemá žiadne tlačidlo Zrušiť, stlačením klávesu esc nemá vplyv.

Ak funkcia zlyhá, vrátená hodnota je nula. Získajte rozšírené informácie o chybách, volajte na číslo GetLastError.

Poznámky

Pri vytváraní systému modalu hlásením naznačujú, že systém má nedostatok pamäte, reťazce prešiel ako parametre lpText a lpCaption by sa nemali brať zo súboru zdroja pretože pokus načítať prostriedok môže zlyhať.

Ak žiadosť zavolá funkciu MessageBoxEx a určuje príznaky MB_ICONHAND a MB_SYSTEMMODAL pre uType parameter rozhranie API systému Win32 zobrazí výsledný hlásením nezávisle od dostupnej pamäte. Keď zadáte tieto príznaky, systém obmedzenia dĺžky okno s hlásením textu do jedného riadka.

Ak vytvoríte okno s hlásením, zatiaľ čo dialógové okno je prítomný, použite rukoväť dialógovom okne ako hWnd parameter. HWnd parameter nemôže rozpoznať dcérskym oknom ako dialógové okno.

Systém Windows 95:Systém môže podporovať maximálne 16,364 popisovače window.

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzia 3.1 alebo novšia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Nepodporované.
Hlavičky:Deklarovaný v súbore winuser.h.
Importovať knižnica:Použiť user32.lib.
Unicode:Implementovaný ako Unicode, ANSI verzia pre Windows a Windows NT.

Pozri tiež

Dialógové okná prehľad, dialógové okno pole funkcie MAKELANGID MessageBeep,okno s hlásením , MessageBoxIndirect, SetForegroundWindow

Index