[wxWidgets.git] / docs / latex / wx / stdevtid.tex

\section{Standard event identifiers}\label{stdevtid}

wxWidgets defines a special identifier value {\tt wxID\_ANY} which is used in
the following two situations:

\begin{itemize}
\item when creating a new window you may specify {\tt wxID\_ANY} to let
wxWidgets assign an unused identifier to it automatically
\item when installing an event handler using either the event table
macros or \helpref{wxEvtHandler::Connect}{wxevthandlerconnect},
you may use it to indicate that you want to handle the events
coming from any control, regardless of its identifier
\end{itemize}

Another standard special identifier value is {\tt wxID\_NONE}: this is a value
which is not matched by any other id.

wxWidgets also defines a few standard command identifiers which may be used by
the user code and also are sometimes used by wxWidgets itself. These reserved
identifiers are all in the range between {\tt wxID\_LOWEST} and 
{\tt wxID\_HIGHEST} and, accordingly, the user code should avoid defining its
own constants in this range.

\begin{verbatim}
    wxID_LOWEST = 4999,

    wxID_OPEN,
    wxID_CLOSE,
    wxID_NEW,
    wxID_SAVE,
    wxID_SAVEAS,
    wxID_REVERT,
    wxID_EXIT,
    wxID_UNDO,
    wxID_REDO,
    wxID_HELP,
    wxID_PRINT,
    wxID_PRINT_SETUP,
    wxID_PAGE_SETUP,
    wxID_PREVIEW,
    wxID_ABOUT,
    wxID_HELP_CONTENTS,
    wxID_HELP_INDEX,
    wxID_HELP_SEARCH,
    wxID_HELP_COMMANDS,
    wxID_HELP_PROCEDURES,
    wxID_HELP_CONTEXT,
    wxID_CLOSE_ALL,

    wxID_CUT = 5030,
    wxID_COPY,
    wxID_PASTE,
    wxID_CLEAR,
    wxID_FIND,
    wxID_DUPLICATE,
    wxID_SELECTALL,
    wxID_DELETE,
    wxID_REPLACE,
    wxID_REPLACE_ALL,
    wxID_PROPERTIES,

    wxID_VIEW_DETAILS,
    wxID_VIEW_LARGEICONS,
    wxID_VIEW_SMALLICONS,
    wxID_VIEW_LIST,
    wxID_VIEW_SORTDATE,
    wxID_VIEW_SORTNAME,
    wxID_VIEW_SORTSIZE,
    wxID_VIEW_SORTTYPE,

    wxID_FILE1 = 5050,
    wxID_FILE2,
    wxID_FILE3,
    wxID_FILE4,
    wxID_FILE5,
    wxID_FILE6,
    wxID_FILE7,
    wxID_FILE8,
    wxID_FILE9,

    // Standard button IDs
    wxID_OK = 5100,
    wxID_CANCEL,
    wxID_APPLY,
    wxID_YES,
    wxID_NO,
    wxID_STATIC,
    wxID_FORWARD,
    wxID_BACKWARD,
    wxID_DEFAULT,
    wxID_MORE,
    wxID_SETUP,
    wxID_RESET,
    wxID_CONTEXT_HELP,
    wxID_YESTOALL,
    wxID_NOTOALL,
    wxID_ABORT,
    wxID_RETRY,
    wxID_IGNORE,

    wxID_UP,
    wxID_DOWN,
    wxID_HOME,
    wxID_REFRESH,
    wxID_STOP,
    wxID_INDEX,

    wxID_BOLD,
    wxID_ITALIC,
    wxID_JUSTIFY_CENTER,
    wxID_JUSTIFY_FILL,
    wxID_JUSTIFY_RIGHT,
    wxID_JUSTIFY_LEFT,
    wxID_UNDERLINE,
    wxID_INDENT,
    wxID_UNINDENT,
    wxID_ZOOM_100,
    wxID_ZOOM_FIT,
    wxID_ZOOM_IN,
    wxID_ZOOM_OUT,
    wxID_UNDELETE,
    wxID_REVERT_TO_SAVED,

    // System menu IDs (used by wxUniv):
    wxID_SYSTEM_MENU = 5200,
    wxID_CLOSE_FRAME,
    wxID_MOVE_FRAME,
    wxID_RESIZE_FRAME,
    wxID_MAXIMIZE_FRAME,
    wxID_ICONIZE_FRAME,
    wxID_RESTORE_FRAME,

    // IDs used by generic file dialog (13 consecutive starting from this value)
    wxID_FILEDLGG = 5900,

    wxID_HIGHEST = 5999
\end{verbatim}
Commit	Line	Data
ab246904 VZ	1	\section{Standard event identifiers}\label{stdevtid}
ab246904 VZ	2
fc2171bd	3	wxWidgets defines a special identifier value {\tt wxID\_ANY} which is used in
ab246904	4	the following two situations:
d2c2afc9	5
ab246904	6	\begin{itemize}
d2c2afc9	7	\item when creating a new window you may specify {\tt wxID\_ANY} to let
fc2171bd	8	wxWidgets assign an unused identifier to it automatically
d2c2afc9 JS	9	\item when installing an event handler using either the event table
	10	macros or \helpref{wxEvtHandler::Connect}{wxevthandlerconnect},
	11	you may use it to indicate that you want to handle the events
	12	coming from any control, regardless of its identifier
ab246904 VZ	13	\end{itemize}
ab246904 VZ	14
dadacffc VZ	15	Another standard special identifier value is {\tt wxID\_NONE}: this is a value
	16	which is not matched by any other id.
	17
fc2171bd JS	18	wxWidgets also defines a few standard command identifiers which may be used by
fc2171bd JS	19	the user code and also are sometimes used by wxWidgets itself. These reserved
ab246904 VZ	20	identifiers are all in the range between {\tt wxID\_LOWEST} and
	21	{\tt wxID\_HIGHEST} and, accordingly, the user code should avoid defining its
	22	own constants in this range.
	23
	24	\begin{verbatim}
	25	wxID_LOWEST = 4999,
	26
	27	wxID_OPEN,
	28	wxID_CLOSE,
	29	wxID_NEW,
	30	wxID_SAVE,
	31	wxID_SAVEAS,
	32	wxID_REVERT,
	33	wxID_EXIT,
	34	wxID_UNDO,
	35	wxID_REDO,
	36	wxID_HELP,
	37	wxID_PRINT,
	38	wxID_PRINT_SETUP,
e63f19ba	39	wxID_PAGE_SETUP,
ab246904 VZ	40	wxID_PREVIEW,
	41	wxID_ABOUT,
	42	wxID_HELP_CONTENTS,
40f51262 VZ	43	wxID_HELP_INDEX,
40f51262 VZ	44	wxID_HELP_SEARCH,
ab246904 VZ	45	wxID_HELP_COMMANDS,
	46	wxID_HELP_PROCEDURES,
	47	wxID_HELP_CONTEXT,
	48	wxID_CLOSE_ALL,
	49
	50	wxID_CUT = 5030,
	51	wxID_COPY,
	52	wxID_PASTE,
	53	wxID_CLEAR,
	54	wxID_FIND,
	55	wxID_DUPLICATE,
	56	wxID_SELECTALL,
e9f4f51d JS	57	wxID_DELETE,
	58	wxID_REPLACE,
	59	wxID_REPLACE_ALL,
	60	wxID_PROPERTIES,
	61
	62	wxID_VIEW_DETAILS,
	63	wxID_VIEW_LARGEICONS,
	64	wxID_VIEW_SMALLICONS,
	65	wxID_VIEW_LIST,
	66	wxID_VIEW_SORTDATE,
	67	wxID_VIEW_SORTNAME,
	68	wxID_VIEW_SORTSIZE,
	69	wxID_VIEW_SORTTYPE,
ab246904 VZ	70
	71	wxID_FILE1 = 5050,
	72	wxID_FILE2,
	73	wxID_FILE3,
	74	wxID_FILE4,
	75	wxID_FILE5,
	76	wxID_FILE6,
	77	wxID_FILE7,
	78	wxID_FILE8,
	79	wxID_FILE9,
	80
	81	// Standard button IDs
	82	wxID_OK = 5100,
	83	wxID_CANCEL,
	84	wxID_APPLY,
	85	wxID_YES,
	86	wxID_NO,
	87	wxID_STATIC,
	88	wxID_FORWARD,
	89	wxID_BACKWARD,
	90	wxID_DEFAULT,
	91	wxID_MORE,
	92	wxID_SETUP,
	93	wxID_RESET,
	94	wxID_CONTEXT_HELP,
	95	wxID_YESTOALL,
	96	wxID_NOTOALL,
	97	wxID_ABORT,
	98	wxID_RETRY,
	99	wxID_IGNORE,
	100
e9f4f51d JS	101	wxID_UP,
	102	wxID_DOWN,
	103	wxID_HOME,
	104	wxID_REFRESH,
	105	wxID_STOP,
	106	wxID_INDEX,
	107
	108	wxID_BOLD,
	109	wxID_ITALIC,
	110	wxID_JUSTIFY_CENTER,
	111	wxID_JUSTIFY_FILL,
	112	wxID_JUSTIFY_RIGHT,
	113	wxID_JUSTIFY_LEFT,
	114	wxID_UNDERLINE,
	115	wxID_INDENT,
	116	wxID_UNINDENT,
	117	wxID_ZOOM_100,
	118	wxID_ZOOM_FIT,
	119	wxID_ZOOM_IN,
	120	wxID_ZOOM_OUT,
	121	wxID_UNDELETE,
	122	wxID_REVERT_TO_SAVED,
	123
ab246904 VZ	124	// System menu IDs (used by wxUniv):
	125	wxID_SYSTEM_MENU = 5200,
	126	wxID_CLOSE_FRAME,
	127	wxID_MOVE_FRAME,
	128	wxID_RESIZE_FRAME,
	129	wxID_MAXIMIZE_FRAME,
	130	wxID_ICONIZE_FRAME,
	131	wxID_RESTORE_FRAME,
	132
	133	// IDs used by generic file dialog (13 consecutive starting from this value)
	134	wxID_FILEDLGG = 5900,
	135
	136	wxID_HIGHEST = 5999
	137	\end{verbatim}
	138