Általános vezérlési referencia

Ez a szakasz olyan programozási elemekre vonatkozó referenciainformációkat tartalmaz, amelyek több vezérlőre vonatkoznak, nem csak egy adott vezérlőre. A legtöbb vezérlő által támogatott függvények, makrók, üzenetek, értesítések és struktúrák támogatottak. A legtöbb vezérlő például az NM_HOVER-értesítéseket használja az egérkattintások feldolgozásához.

• áttekintési
• Functions
• makrók
• Üzenetek
• értesítések
• struktúrák
• állandók

Áttekintés

Téma	Tartalomjegyzék
A gyakori vezérlők	A közös vezérlők a közös vezérlőtár által implementált ablakok, amelyek a Windows operációs rendszer dll-jének részét képezik.
gyakori vezérlők – gyakori kérdések	Ez a gyakori kérdések választ adnak a gyakori vezérlőkkel kapcsolatos gyakori kérdésekre.

Functions

Téma	Tartalomjegyzék
DoReaderMode	Olvasó mód engedélyezése az ablakban.
DPA_Clone	Egy dinamikus mutatótömb (DPA) duplikálása.
DPA_Create	Létrehoz egy DPA-t.
DPA_CreateEx	Létrehoz egy DPA-t egy megadott méret és halomhely használatával.
DPA_DeleteAllPtrs	Eltávolítja az összes elemet egy DPA-ból, és ennek megfelelően zsugorítja a DPA-t.
DPA_DeletePtr	Eltávolít egy elemet egy DPA-ból. A DPA szükség esetén zsugorodik az eltávolított elem elhelyezéséhez.
DPA_Destroy	Felszabadít egy dinamikus mutatótömböt (DPA).
DPA_DestroyCallback	Meghívja pfnCB a DPA minden elemére, majd felszabadítja a DPA-t.
DPA_EnumCallback	Végigfut a dinamikus mutatótömbön (DPA), és meghívja pfnCB minden elemen.
DPA_GetPtr	Lekéri az elemet egy DPA-ból.
DPA_GetPtrIndex	Lekéri a DPA-ban talált egyező elem indexét.
DPA_GetSize	Lekéri a DPA méretét.
DPA_Grow	A DPA mutatóinak számát módosítja.
DPA_InsertPtr	Új elemet szúr be egy adott pozícióba egy DPA-ban. Szükség esetén a DPA kibővül az új elem elhelyezéséhez.
DPA_LoadStream	Betölti a DPA-t egy streamből úgy, hogy meghívja a megadott visszahívási függvényt az egyes elemek beolvasásához.
DPA_Merge	Két DPA tartalmát egyesíti.
DPA_SaveStream	A DPA-t egy streambe menti egy fejléc kiírásával, majd meghívja a megadott visszahívási függvényt az egyes elemek írásához.
DPA_Search	Megkeres egy elemet egy DPA-ban.
DPA_SetPtr	Érték hozzárendelése egy DPA-beli elemhez.
DPA_Sort	A dinamikus mutatótömb (DPA) elemeinek rendezése.
DrawShadowText	Árnyékot tartalmazó szöveget rajzol.
DrawTextExPrivWrap	Formázott szöveget rajzol a megadott téglalapban. Ez a függvény körbefuttat egy hívást DrawTextEx.
DrawTextWrap	Formázott szöveget rajzol a megadott téglalapban. A szöveg formázása a megadott módszer szerint (fülek kibontása, karakterek beigazolása, törésvonalak stb.). Ez a függvény körbefuttat egy hívást DrawText.
DSA_Clone	Egy dinamikus struktúratömb (DSA) duplikálása.
DSA_Create	Létrehoz egy DSA-t.
DSA_DeleteAllItems	Törli az összes elemet egy DSA-ból.
DSA_DeleteItem	Egy elemet töröl egy DSA-ból.
DSA_Destroy	Felszabadít egy DSA-t.
DSA_DestroyCallback	Az iterálás egy DSA-n keresztül történik, és minden elemen meghív egy adott visszahívási függvényt. A tömb végére érve a DSA felszabadul.
DSA_EnumCallback	Iterál a DSA-n keresztül, és meghívja pfnCB minden egyes elemen.
DSA_GetItem	Lekéri az elemet egy DSA-ból.
DSA_GetItemPtr	Egy DSA egy elemére mutató mutatót kap.
DSA_GetSize	Lekéri a DSA méretét.
DSA_InsertItem	Új elemet szúr be egy DSA-ba. Szükség esetén a DSA kibővül az új elem elhelyezéséhez.
DSA_SetItem	Beállítja egy elem tartalmát egy DSA-ban.
DSA_Sort	A DSA elemeinek rendezése.
ExtTextOutWrap	A jelenleg kijelölt betűtípussal, háttérszínnel és szövegszínnel rajzol szöveget. Megadhat dimenziókat a kivágáshoz, az átlátszatlansághoz vagy mindkettőhöz. Ez a függvény az ExtTextOuthívását tördeli.
GetEffectiveClientRect	Kiszámítja egy téglalap méretét az ügyfélterületen, amely az összes megadott vezérlőt tartalmazza.
GetMUILanguage	Lekéri az adott folyamat közös vezérlői által jelenleg használt nyelvet.
GetTextExtentPoint32Wrap	Kiszámítja a megadott szövegsztring szélességét és magasságát. Ez a függvény körbefuttat egy hívást GetTextExtentPoint.
InitCommonControls	Regisztrál és inicializál bizonyos gyakori vezérlőablak-osztályokat. Ez a függvény elavult. Az új alkalmazásoknak az InitCommonControlsEx függvényt kell használniuk.
InitCommonControlsEx	A közös vezérlő DLL-ből regisztrálja az egyes közös vezérlőosztályokat.
InitMUILanguage	Lehetővé teszi egy alkalmazás számára, hogy a rendszernyelvtől eltérő közös vezérlőkkel használandó nyelvet adjon meg.
LoadIconMetric	Betölt egy megadott ikonerőforrást egy ügyfél által megadott rendszermetrikával.
LoadIconWithScaleDown	Betölt egy ikont. Ha az ikon nem szabványos méretű, akkor ez a függvény a kisebb kép méretezése helyett egy nagyobb képet skáláz le.
MirrorIcon	Megfordítja a tükrözött ikonokat, hogy megfelelően jelenjenek meg egy tükrözött eszközkörnyezetben.
PFNDACOMPARE	Meghatározza a DSA_Sortáltal használt összehasonlítási függvény prototípusát.
PFNDACOMPARECONST	Meghatározza a DSA_Sort által használt összehasonlítási függvény prototípusát, amikor az összehasonlítandó elemek állandó objektumok.
PFNDAENUMCALLBACK	Meghatározza a DSA és a DPA függvény által használt visszahívási függvény prototípusát.
PFNDAENUMCALLBACKCONST	Meghatározza a DSA és a DPA függvény által használt visszahívási függvény prototípusát, amikor az érintett elemek állandó adatokra mutatnak.
PFNDPACOMPARE	Meghatározza a DPA_Sort és DPA_Searcháltal használt összehasonlítási függvény prototípusát.
PFNDPACOMPARECONST	Meghatározza a DPA_Sort vagy DPA_Search által használt összehasonlítási függvény prototípusát, amikor az összehasonlítandó elemek állandó objektumok.
PFNDPAENUMCALLBACK	Meghatározza a DPA_EnumCallbackáltal használt visszahívási függvény prototípusát.
PFNDPAMERGE	Meghatározza a DPA_Mergeáltal használt egyesítési függvény prototípusát.
PFNDPAMERGECONST	A DPA_Mergeáltal használt egyesítési függvény prototípusát határozza meg állandó értékekkel.
PFNDPASTREAM	Meghatározza a DPA_LoadStream és DPA_SaveStreamáltal használt visszahívási függvény prototípusát.
PFNDSAENUMCALLBACK	Meghatározza a DSA_DestroyCallbackáltal használt visszahívási függvény prototípusát.
ReaderScroll	Alkalmazás által definiált visszahívási függvény, amely akkor használatos, ha az egérmutatót az olvasó mód ablakának aktív görgetési területként deklarált részen belül helyezi át.
ShowHideMenuCtl	Beállítja vagy eltávolítja a megadott menüelem pipa attribútumát, és megjeleníti vagy elrejti a megfelelő vezérlőt. A függvény pipát ad a megadott menüelemhez, ha nincs, majd megjeleníti a megfelelő vezérlőt. Ha a menüelem már rendelkezik pipával, a függvény eltávolítja a pipát, és elrejti a megfelelő vezérlőt.
Str_GetPtr	Sztringet másol az egyik pufferből a másikba.
Str_SetPtrW	Beállítja ppszCurrentpszNew másolatára, és szükség esetén felszabadítja az előző értéket.
TranslateDispatch	A DoReaderMode függvény ügyfele használja az olvasó mód ablakának görgetési területére célzott ablaküzenetek elfogására és explicit kezelésére. Ez egy alkalmazás által definiált visszahívási függvény.

Makrók

Téma	Tartalomjegyzék
DPA_AppendPtr	Új elemet szúr be egy DPA végére.
DPA_FastDeleteLastPtr	Törli az utolsó mutatót egy DPA-ból.
DPA_FastGetPtr	Lekéri a megadott mutató értékét a DPA-ban.
DPA_GetPtrCount	A DPA mutatóinak számát adja meg.
DPA_GetPtrPtr	Lekéri az egérmutatót egy DPA belső mutatótömbje felé.
DPA_SetPtrCount	A DPA mutatóinak számát állítja be.
DPA_SortedInsertPtr	Új elemet szúr be egy megadott meglévő elem elé vagy után.
DSA_AppendItem	Hozzáfűz egy új elemet egy DSA végéhez.
DSA_GetItemCount	Lekéri a DSA elemeinek számát.
FORWARD_WM_NOTIFY	Elküldi vagy közzéteszi a WM_NOTIFY üzenetet.
HANDLE_WM_NOTIFY	Meghív egy függvényt, amely feldolgozza a WM_NOTIFY üzenetet.
INDEXTOSTATEIMAGEMASK	Előkészíti az állapotkép indexét, hogy egy fanézetű vezérlő vagy listanézet vezérlőelem az index használatával lekérhesse az elem állapotképét.

Üzenetek

Téma	Tartalomjegyzék
CCM_DPISCALE	Lehetővé teszi Tree-View vezérlők, List-View vezérlők, ComboBoxEx vezérlők, Fejlécvezérlők, Gombok, Eszköztár vezérlők, Animáció vezérlőkés Képlisták.
CCM_GETUNICODEFORMAT	Lekéri a vezérlő Unicode-karakterformázási jelzőt.
CCM_GETVERSION	Lekéri a legújabb CCM_SETVERSION üzenet által beállított vezérlőelem verziószámát.
CCM_SETUNICODEFORMAT	Beállítja a vezérlő Unicode karakterformátum-jelölőjének beállítását. Ez az üzenet lehetővé teszi, hogy futásidőben módosítsa a vezérlő által használt karakterkészletet a vezérlő újbóli létrehozása helyett.
CCM_SETVERSION	Ez az üzenet arról tájékoztatja a vezérlőt, hogy egy adott verzióhoz kapcsolódó viselkedést vár.
CCM_SETWINDOWTHEME	Beállítja egy vezérlőelem vizuális stílusát.
WM_NOTIFY	Egy közös vezérlő küldi el a szülőablakba, amikor esemény történt, vagy a vezérlő némi információt igényel.
WM_NOTIFYFORMAT	Meghatározza, hogy egy ablak elfogadja-e az ANSI- vagy Unicode-struktúrákat a WM_NOTIFY értesítési üzenetben. WM_NOTIFYFORMAT üzeneteket a rendszer egy közös vezérlőből a szülőablakba, a szülőablakból pedig a közös vezérlőbe küldi.

Értesítések

Téma	Tartalomjegyzék
NM_CHAR	A NM_CHAR értesítési kódot egy vezérlő küldi el egy karakterkulcs feldolgozásakor. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_CUSTOMDRAW	Értesíti a vezérlő szülőablakát az egyéni rajzműveletekről. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_CUSTOMTEXT	Értesíti a vezérlő szülőablakát az egyéni szövegműveletekről. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_FONTCHANGED	Listanézet-vezérlő küldi el, ha a vezérlő módosított egy betűtípust. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_GETCUSTOMSPLITRECT	Egy gombvezérlő küldi el a szülőnek az osztott gombot alkotó két téglalap méréseinek lekéréséhez. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_HOVER	Egy vezérlő küldi el, amikor az egér rámutat egy elemre. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_KEYDOWN	Egy vezérlő küldi el, ha a vezérlő fókusza a billentyűzetre kerül, és a felhasználó lenyom egy billentyűt. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_KILLFOCUS	Értesíti a vezérlő szülőablakát, hogy a vezérlő elvesztette a bemeneti fókuszt. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_LDOWN	Értesíti a vezérlő szülőablakát, hogy a bal egérgombot lenyomta. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_NCHITTEST	Ha a vezérlő WM_NCHITTEST üzenetet kap, egy rebar vezérlő küldi el. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_OUTOFMEMORY	Értesíti a vezérlő szülőablakát, hogy a vezérlő nem tudott végrehajtani egy műveletet, mert nem volt elegendő memória. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_RDOWN	Jelenleg nem támogatott.
NM_RELEASEDCAPTURE	Értesíti a vezérlő szülőablakát, hogy a vezérlő egérrögzítést bocsát ki. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_RETURN	Értesíti a vezérlő szülőablakát, hogy a vezérlő fókusza a bemeneti fókusz, és hogy a felhasználó lenyomta az ENTER billentyűt. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_SETCURSOR	Értesíti a vezérlő szülőablakát, hogy a vezérlő egy NM_SETCURSOR üzenetre válaszul állítja be a kurzort. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_SETFOCUS	Értesíti a vezérlő szülőablakát, hogy a vezérlő megkapta a bemeneti fókuszt. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_THEMECHANGED	Értesíti a vezérlő szülőablakát, hogy a téma megváltozott. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_TOOLTIPSCREATED	Értesíti a vezérlő szülőablakát, hogy a vezérlő létrehozott egy elemleírás-vezérlőt. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.
NM_TVSTATEIMAGECHANGING	Egy fanézet vezérlőelem küldi el a szülőablakba, hogy az állapotkép megváltozik. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer.

Struktúrák

Téma	Tartalomjegyzék
COLORSCHEME	Az eszköztár vagy a sáv gombjainak rajzára vonatkozó információkat tartalmazza.
DPASTREAMINFO	A PFNDPASTREAM visszahívási függvény által használt streamelemet tartalmazza.
INITCOMMONCONTROLSEX	A dinamikus csatolású kódtárból (DLL) származó gyakori vezérlőosztályok betöltéséhez használt információkat tartalmazza. Ez a struktúra az InitCommonControlsEx függvénnyel használható.
NMCHAR	A karakterértesítési üzenetekhez használt információkat tartalmazza.
NMCUSTOMSPLITRECTINFO	Az osztott gomb két téglalapjáról tartalmaz információt. A NM_GETCUSTOMSPLITRECT értesítéssel küldve.
NMCUSTOMTEXT	Egyéni szöveges értesítéshez használt információkat tartalmaz.
NMHDR	Információt tartalmaz egy értesítési üzenetről.
NMKEY	A kulcsértesítési üzenetekhez használt információkat tartalmazza.
NMMOUSE	Az egér értesítési üzeneteivel kapcsolatos információkat tartalmazza.
NMOBJECTNOTIFY	A TBN_GETOBJECT, TCN_GETOBJECTés PSN_GETOBJECT értesítési kódokkal használt információkat tartalmazza.
NMTOOLTIPSCREATED	Az értesítési kód NM_TOOLTIPSCREATED használt információkat tartalmazza.
READERMODEINFO	A DoReaderMode függvény inicializálásához szükséges információkat tartalmazza.

Állandók

Téma	Tartalomjegyzék
CDRF-állandók	Ezeket az állandókat egy vezérlő egy NM_CUSTOMDRAW értesítési kódra válaszul használja eredményértékként.
Stílusok	Ez a szakasz a gyakori vezérlőstílusokat sorolja fel. A feljegyzett esetek kivételével ezek a stílusok a fejlécvezérlőkre, az eszköztár-vezérlőkre és az állapotablakokra vonatkoznak.
ablakosztályok	Ez a szakasz a közös vezérlőtár által megadott ablakosztályneveket sorolja fel.