EM_SETTEXTMODE üzenet

A rich edit vezérlőelem szövegmódját vagy visszavonási szintjét állítja be. Az üzenet meghiúsul, ha a vezérlő szöveget tartalmaz.

Paraméterek

wParam

Egy vagy több érték a TEXTMODE enumerálási típusból. Az értékek megadják a vezérlő szövegmódjának új beállításait, és visszavonják a szint paramétereit.

A szöveges mód paraméterének beállításához adja meg az alábbi értékek egyikét. Ha nem ad meg szöveges módértéket, a szöveges mód az aktuális beállításnál marad.

Érték	Értelmezés
TM_PLAINTEXT	Egyszerű szöveges módot jelez, amelyben a vezérlő hasonló a szokásos szerkesztési vezérlőhöz. Az egyszerű szöveges módról az alábbi Megjegyzések szakaszban talál további információt.
TM_RICHTEXT	Rich Text módot jelöl, amelyben a vezérlő szabványos rich edit funkcióval rendelkezik. A Rich Text mód az alapértelmezett beállítás.

Adja meg az alábbi értékek egyikét a visszavonási szint paraméterének beállításához. Ha nem ad meg visszavonási szintű értéket, a visszavonási szint a jelenlegi beállításnál marad.

Érték	Értelmezés
TM_SINGLELEVELUNDO	A vezérlő lehetővé teszi, hogy a felhasználó csak az utolsó visszavonható műveletet vonja vissza.
TM_MULTILEVELUNDO	A vezérlő több visszavonási műveletet is támogat. Ez az alapértelmezett beállítás. A visszavonási műveletek maximális számának beállításához használja a EM_SETUNDOLIMIT üzenetet.

Adja meg az alábbi értékek egyikét a kódlap paraméterének beállításához. Ha nem ad meg kódlapértéket, a kódlap a jelenlegi beállításnál marad.

Érték	Értelmezés
TM_SINGLECODEPAGE	A vezérlő csak az angol billentyűzetet és az alapértelmezett karakterkészletnek megfelelő billentyűzetet engedélyezi. Lehet például görög és angol. Vegye figyelembe, hogy ez megakadályozza, hogy a Unicode-szöveg beírja a vezérlőt. Használja például ezt az értéket, ha a Rich Edit vezérlőelemnek ANSI-szövegre kell korlátozódnia.
TM_MULTICODEPAGE	A vezérlőelem több kódlapot és Unicode-szöveget is engedélyez a vezérlőbe. Ez az alapértelmezett beállítás.

lParam

Ez a paraméter nem használatos; nullának kell lennie.

Visszaadott érték

Ha az üzenet sikeres, a visszatérési érték nulla.

Ha az üzenet sikertelen, a visszatérési érték nem érték.

Megjegyzések

Rich Text módban a rich edit vezérlő szabványos rich edit funkcióval rendelkezik. Egyszerű szöveges módban azonban a vezérlő a szokásos szerkesztési vezérlőhöz hasonló:

• Az egyszerű szövegvezérlő szövegének csak egy formátuma lehet (például félkövér, 10 pontos Arial).
• A felhasználó nem illeszthet be rich text formátumokat, például Rich Text Format (RTF) vagy beágyazott objektumokat egy egyszerű szövegvezérlőbe.
• A rich text módú vezérlők mindig rendelkeznek alapértelmezett dokumentumvégi jelölővel vagy kocsivisszajelekkel a bekezdések formázásához. Az egyszerű szövegvezérlőknek viszont nincs szükségük az alapértelmezett, dokumentumvégi jelölőre, ezért nincs megadva.

A vezérlő nem tartalmazhat szöveget, amikor megkapja a EM_SETTEXTMODE üzenetet. Ha meg szeretné győződni arról, hogy nincs szöveg, küldjön egy WM_SETTEXT üzenetet egy üres sztringgel ("").

Követelmények

Követelmény	Érték
Minimálisan támogatott ügyfél	Windows Vista [csak asztali alkalmazások]
Minimálisan támogatott kiszolgáló	Windows Server 2003 [csak asztali alkalmazások]
Fejléc	Richedit.h

Lásd még

EM_GETTEXTMODE

EM_SETUNDOLIMIT

TEXTMODE

WM_SETTEXT