Okno s hlásením

Okno s hlásením funkcia vytvára, zobrazuje a pracuje 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.

int (okno s hlásením HWND  hWnd; / / zvládnuť vlastník oknoLPCTSTRlpText; / / address text v okne hláseniaLPCTSTRlpCaption; / / address hlavy okno s hlásenímUINTuType / / štýl okna hlásenia);

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.

lpText

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

lpCaption

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.

Note:

Vrátená hodnota je nula, ak nie je dostatok pamäte na vytvorenie v okne s hlásením.

Ak funkciu podarí, vrátená hodnota je jedným z nasledovných položka ponuky hodnoty vrátené v dialógovom okne:

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 ak stlačení klávesu esc alebo tlačidla zrušiť je začiarknuté. Ak v okne s hlásením sa žiadne tlačidlo zrušiť stlačením esc nemá vplyv.

Poznámky

Keď použijete systém modalu hlásením na naznačujú, že systém má nedostatok pamäte, reťazce poukázal v lpText a lpCaption parametre by sa nemali brať zo zdroja súboru, pretože pokus načítať prostriedok môže zlyhať.

Keď aplikácia vyžaduje okno s hlásením a určuje príznaky MB_ICONHAND a MB_SYSTEMMODAL parametra uType , systém zobrazí výsledný hlásením nezávisle od dostupnej pamäte. Keď sú špecifikované tieto príznaky, systém obmedzuje dĺžku blok textu správy do troch riadkov. Systém nemá nie automaticky prelomiť riadky prispôsobiť v okne hlásenia však tak reťazec správy musia obsahovať znakmi prelomiť riadky na primeraných miestach.

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 napríklad kontrola v dialógovom okne.

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

Windows CE: Windows CE nepodporuje nasledujúcimi štýlmi pre uType parameter

MB_SYSTEMMODAL

MB_TASKMODAL

MB_HELP

MB_RIGHT

MB_RTLREADING

MB_DEFAULT_DESKTOP_ONLY

MB_SERVICE_NOTIFICATION

MB_USERICON.

Vráti nasledovné hodnoty nie sú podporované:

IDCLOSE

IDHELP

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:Vyžaduje verziu 1.0 alebo novšiu verziu.
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 FlashWindow MessageBeep, MessageBoxEx, MessageBoxIndirect, SetForegroundWindow

Index