Status XSendEvent(display, w, propagate, event_mask, event_send)
	Display *display;
	Window w;
	Bool propagate;
	long event_mask;
	XEvent *event_send;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• w - идентификатор окна, которому предназначается событие;
• propagate - флаг, влияющий на выбор получателя события;
• event_mask - битовая маска события;
• event_send - отправляемое событие.

     Функция XSendEvent рассылает событие всем клиентам, установившим получение событий для окна w, соответствующих маске event_mask. Клиент получит это событие, если он установил маску получения событий, в которой есть общие разряды с event_mask, установленные в единицу. Или говоря другими словами, результат логического умножения маски, установленной клиентом и event_mask должен быть не равен нулю. При отправке событий через XSendEvent установки на монопольный захват получения событий игнорируются.

     Кроме указания идентификатора окна в аргументе w можно использовать следующие значения:

• PointerWindow - в качестве получателя события будет выбрано окно, над которым находится графический курсор мыши;
• InputFocus - в качестве получателя события будет выбрано окно, которому принадлежит фокус ввода с клавиатуры.

     Кроме этого, для дополнительного выбора клиентов, которым необходимо разослать сообщение можно использовать следующие варианты:

• Если event_mask равен нулю, то событие отсылается только клиенту, создавшему окно. Если этот клиент уже не существует, то событие никому не отправляется.

   

• Если propagate равен False, то событие рассылается всем клиентам, запросившим получение событий, сгенерированных для окна w и соответствующих маске event_mask.

   

• Если propagate равен True, w не равен InputFocus и нет таких клиентов, которые бы получали события, указанные в event_mask для окна w, то поиск получателя происходит по окнам-предкам. Ищется ближайший предок, для которого выбрано получение событий типа event_mask. Поиск может быть ограничен параметром do_not_propagate_mask (см. XSetWindowAttributes) как самого окна w, так и каким-либо окном-предком. Если в процессе поиска попадается do_not_propagate_mask, который запрещает подобное распространение событий типа event_mask, то поиск прекращается и событие никому не посылается. Если подходящее окно найдено не было, то событие также никому не посылается. Если окно было найдено, то событие рассылается всем клиентам, выбравшим получение событий указанного типа для найденного окна.

     Чтобы в случае необходимости X-сервер мог корректно произвести преобразования в порядке следования байтов, event_send должен быть одним из базовых событий системы X Window или событием, определённым в расширениях системы. Иначе сервер оставляет событие нетронутым, за исключением полей send_event и serial, которые сервер заполняет своими значениеями в любом случае. Поэтому эти два поля, а также поле display при отправке события игнорируются.

     В случае успешной отправки события XSendEvent возвращает ненулевое значение статуса. Если же событие по каким-то причинам отправлено не было, то статус будет нулевым.

Cм. также: XNextEvent, XPeekEvent, XWindowEvent, XCheckWindowEvent, XMaskEvent, XCheckMaskEvent, XCheckTypedEvent, XPutBackEvent.