X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/debe6624c1e9d4bf3243381153d1e173c849bcd8..6af984df34c71bc14648a7b5bf1ad3c3cd07fc05:/src/gtk1/radiobox.cpp diff --git a/src/gtk1/radiobox.cpp b/src/gtk1/radiobox.cpp index c449676506..7aab3d84f8 100644 --- a/src/gtk1/radiobox.cpp +++ b/src/gtk1/radiobox.cpp @@ -1,229 +1,616 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: radiobox.cpp +// Name: src/gtk1/radiobox.cpp // Purpose: // Author: Robert Roebling -// Created: 01/02/97 -// Id: -// Copyright: (c) 1998 Robert Roebling, Julian Smart and Markus Holzem -// Licence: wxWindows licence +// Id: $Id$ +// Copyright: (c) 1998 Robert Roebling +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// +// For compilers that support precompilation, includes "wx.h". +#include "wx/wxprec.h" -#ifdef __GNUG__ -#pragma implementation "radiobox.h" -#endif +#if wxUSE_RADIOBOX #include "wx/radiobox.h" -#include "wx/dialog.h" -#include "wx/frame.h" -#include "wx/gtk/win_gtk.h" + +#ifndef WX_PRECOMP + #include "wx/log.h" + #include "wx/frame.h" + #include "wx/dialog.h" +#endif + +#include "wx/gtk1/private.h" +#include + +#include "wx/gtk1/win_gtk.h" //----------------------------------------------------------------------------- -// wxRadioBox +// idle system +//----------------------------------------------------------------------------- + +extern void wxapp_install_idle_handler(); +extern bool g_isIdle; + +//----------------------------------------------------------------------------- +// data //----------------------------------------------------------------------------- -void gtk_radiobutton_clicked_callback( GtkWidget *WXUNUSED(widget), gpointer data ) +extern bool g_blockEventsOnDrag; +extern wxWindowGTK *g_delayedFocus; + +//----------------------------------------------------------------------------- +// "clicked" +//----------------------------------------------------------------------------- + +extern "C" { +static void gtk_radiobutton_clicked_callback( GtkToggleButton *button, wxRadioBox *rb ) { - wxRadioBox *rb = (wxRadioBox*)data; - wxCommandEvent event( wxEVT_COMMAND_RADIOBOX_SELECTED, rb->GetId() ); - event.SetInt( rb->GetSelection() ); - wxString tmp( rb->GetStringSelection() ); - event.SetString( WXSTRINGCAST(tmp) ); - event.SetEventObject( rb ); - rb->ProcessEvent(event); -}; + if (g_isIdle) wxapp_install_idle_handler(); + + if (!rb->m_hasVMT) return; + if (g_blockEventsOnDrag) return; + if (!button->active) return; + + wxCommandEvent event( wxEVT_COMMAND_RADIOBOX_SELECTED, rb->GetId() ); + event.SetInt( rb->GetSelection() ); + event.SetString( rb->GetStringSelection() ); + event.SetEventObject( rb ); + rb->HandleWindowEvent(event); +} +} + +//----------------------------------------------------------------------------- +// "key_press_event" //----------------------------------------------------------------------------- -IMPLEMENT_DYNAMIC_CLASS(wxRadioBox,wxControl) +extern "C" { +static gint gtk_radiobox_keypress_callback( GtkWidget *widget, GdkEventKey *gdk_event, wxRadioBox *rb ) +{ + if (g_isIdle) + wxapp_install_idle_handler(); -wxRadioBox::wxRadioBox(void) + if (!rb->m_hasVMT) return FALSE; + if (g_blockEventsOnDrag) return FALSE; + + if ((gdk_event->keyval != GDK_Up) && + (gdk_event->keyval != GDK_Down) && + (gdk_event->keyval != GDK_Left) && + (gdk_event->keyval != GDK_Right)) + { + return FALSE; + } + + wxList::compatibility_iterator node = rb->m_boxes.Find( (wxObject*) widget ); + if (!node) + { + return FALSE; + } + + gtk_signal_emit_stop_by_name( GTK_OBJECT(widget), "key_press_event" ); + + if ((gdk_event->keyval == GDK_Up) || + (gdk_event->keyval == GDK_Left)) + { + if (node == rb->m_boxes.GetFirst()) + node = rb->m_boxes.GetLast(); + else + node = node->GetPrevious(); + } + else + { + if (node == rb->m_boxes.GetLast()) + node = rb->m_boxes.GetFirst(); + else + node = node->GetNext(); + } + + GtkWidget *button = (GtkWidget*) node->GetData(); + + gtk_widget_grab_focus( button ); + + return TRUE; +} +} + +extern "C" { +static gint gtk_radiobutton_focus_in( GtkWidget *WXUNUSED(widget), + GdkEvent *WXUNUSED(event), + wxRadioBox *win ) { -}; + if ( win->m_lostFocus ) + { + // no, we didn't really lose it + win->m_lostFocus = FALSE; + } + else if ( !win->m_hasFocus ) + { + win->m_hasFocus = true; + + wxFocusEvent event( wxEVT_SET_FOCUS, win->GetId() ); + event.SetEventObject( win ); -wxRadioBox::wxRadioBox( wxWindow *parent, wxWindowID id, const wxString& title, - const wxPoint &pos, const wxSize &size, - int n, const wxString choices[], - int majorDim, long style, - const wxString &name ) + // never stop the signal emission, it seems to break the kbd handling + // inside the radiobox + (void)win->HandleWindowEvent( event ); + } + + return FALSE; +} +} + +extern "C" { +static gint gtk_radiobutton_focus_out( GtkWidget *WXUNUSED(widget), + GdkEvent *WXUNUSED(event), + wxRadioBox *win ) { - Create( parent, id, title, pos, size, n, choices, majorDim, style, name ); -}; + // wxASSERT_MSG( win->m_hasFocus, _T("got focus out without any focus in?") ); + // Replace with a warning, else we dump core a lot! + // if (!win->m_hasFocus) + // wxLogWarning(_T("Radiobox got focus out without any focus in.") ); + + // we might have lost the focus, but may be not - it may have just gone to + // another button in the same radiobox, so we'll check for it in the next + // idle iteration (leave m_hasFocus == true for now) + win->m_lostFocus = true; + + return FALSE; +} +} + +//----------------------------------------------------------------------------- +// wxRadioBox +//----------------------------------------------------------------------------- + +IMPLEMENT_DYNAMIC_CLASS(wxRadioBox,wxControl) + +void wxRadioBox::Init() +{ + m_needParent = true; + m_acceptsFocus = true; + + m_hasFocus = + m_lostFocus = false; +} + +bool wxRadioBox::Create( wxWindow *parent, wxWindowID id, + const wxString& title, + const wxPoint &pos, const wxSize &size, + const wxArrayString& choices, int majorDim, + long style, const wxValidator& validator, + const wxString &name ) +{ + wxCArrayString chs(choices); + + return Create( parent, id, title, pos, size, chs.GetCount(), + chs.GetStrings(), majorDim, style, validator, name ); +} bool wxRadioBox::Create( wxWindow *parent, wxWindowID id, const wxString& title, - const wxPoint &pos, const wxSize &size, - int n, const wxString choices[], - int WXUNUSED(majorDim), long style, - const wxString &name ) -{ - m_needParent = TRUE; - - PreCreation( parent, id, pos, size, style, name ); - - m_widget = gtk_frame_new( title ); - - int x = m_x+5; - int y = m_y+15; - int maxLen = 0; - int height = 20; - -// if (((m_style & wxRA_VERTICAL) == wxRA_VERTICAL) && (n > 0)) - if (n > 0) - { - GSList *radio_button_group = NULL; + const wxPoint &pos, const wxSize &size, + int n, const wxString choices[], int majorDim, + long style, const wxValidator& validator, + const wxString &name ) +{ + if (!PreCreation( parent, pos, size ) || + !CreateBase( parent, id, pos, size, style, validator, name )) + { + wxFAIL_MSG( wxT("wxRadioBox creation failed") ); + return false; + } + + m_widget = gtk_frame_new(NULL); + SetLabel(title); + if ( HasFlag(wxNO_BORDER) ) + { + // If we don't do this here, the wxNO_BORDER style is ignored in Show() + gtk_frame_set_shadow_type(GTK_FRAME(m_widget), GTK_SHADOW_NONE); + } + + // majorDim may be 0 if all trailing parameters were omitted, so don't + // assert here but just use the correct value for it + SetMajorDim(majorDim == 0 ? n : majorDim, style); + + + unsigned int num_of_cols = GetColumnCount(); + unsigned int num_of_rows = GetRowCount(); + + GtkRadioButton *m_radio = (GtkRadioButton*) NULL; + + GtkWidget *table = gtk_table_new( num_of_rows, num_of_cols, FALSE ); + gtk_table_set_col_spacings( GTK_TABLE(table), 1 ); + gtk_table_set_row_spacings( GTK_TABLE(table), 1 ); + gtk_widget_show( table ); + gtk_container_add( GTK_CONTAINER(m_widget), table ); + + wxString label; + GSList *radio_button_group = (GSList *) NULL; for (int i = 0; i < n; i++) { - if (i) radio_button_group = gtk_radio_button_group( GTK_RADIO_BUTTON(m_radio) ); - m_radio = GTK_RADIO_BUTTON( gtk_radio_button_new_with_label( radio_button_group, choices[i] ) ); - - if (!i) gtk_toggle_button_set_state( GTK_TOGGLE_BUTTON(m_radio), TRUE ); - - gtk_signal_connect( GTK_OBJECT(m_radio), "clicked", - GTK_SIGNAL_FUNC(gtk_radiobutton_clicked_callback), (gpointer*)this ); - - gtk_myfixed_put( GTK_MYFIXED(m_parent->m_wxwindow), GTK_WIDGET(m_radio), x, y ); - - int tmp = 22+gdk_string_measure( GTK_WIDGET(m_radio)->style->font, choices[i] ); - if (tmp > maxLen) maxLen = tmp; - - int width = m_width-10; - if (size.x == -1) width = tmp; - gtk_widget_set_usize( GTK_WIDGET(m_radio), width, 20 ); - - y += 20; - height += 20; - - }; - }; - - wxSize newSize = size; - if (newSize.x == -1) newSize.x = maxLen+10; - if (newSize.y == -1) newSize.y = height; - SetSize( newSize.x, newSize.y ); - - PostCreation(); - - Show( TRUE ); - - return TRUE; -}; - -bool wxRadioBox::Show( bool show ) -{ - wxWindow::Show( show ); - - GSList *item = gtk_radio_button_group( m_radio ); - while (item) - { - GtkWidget *w = GTK_WIDGET( item->data ); - if (show) gtk_widget_show( w ); else gtk_widget_hide( w ); - item = item->next; - }; - - return TRUE; -}; - -int wxRadioBox::FindString( const wxString& WXUNUSED(s) ) const -{ - return 0; -}; - -void wxRadioBox::SetSelection( int WXUNUSED(n) ) -{ -}; + if ( i != 0 ) + radio_button_group = gtk_radio_button_group( GTK_RADIO_BUTTON(m_radio) ); + + label.Empty(); + for ( const wxChar *pc = choices[i]; *pc; pc++ ) + { + if ( *pc != wxT('&') ) + label += *pc; + } + + m_radio = GTK_RADIO_BUTTON( gtk_radio_button_new_with_label( radio_button_group, wxGTK_CONV( label ) ) ); + gtk_widget_show( GTK_WIDGET(m_radio) ); + + gtk_signal_connect( GTK_OBJECT(m_radio), "key_press_event", + GTK_SIGNAL_FUNC(gtk_radiobox_keypress_callback), (gpointer)this ); + + m_boxes.Append( (wxObject*) m_radio ); + + if (HasFlag(wxRA_SPECIFY_COLS)) + { + int left = i%num_of_cols; + int right = (i%num_of_cols) + 1; + int top = i/num_of_cols; + int bottom = (i/num_of_cols)+1; + gtk_table_attach( GTK_TABLE(table), GTK_WIDGET(m_radio), left, right, top, bottom, + GTK_FILL, GTK_FILL, 1, 1 ); + } + else + { + int left = i/num_of_rows; + int right = (i/num_of_rows) + 1; + int top = i%num_of_rows; + int bottom = (i%num_of_rows)+1; + gtk_table_attach( GTK_TABLE(table), GTK_WIDGET(m_radio), left, right, top, bottom, + GTK_FILL, GTK_FILL, 1, 1 ); + } + + ConnectWidget( GTK_WIDGET(m_radio) ); + + if (!i) gtk_toggle_button_set_state( GTK_TOGGLE_BUTTON(m_radio), TRUE ); + + gtk_signal_connect( GTK_OBJECT(m_radio), "clicked", + GTK_SIGNAL_FUNC(gtk_radiobutton_clicked_callback), (gpointer*)this ); + + gtk_signal_connect( GTK_OBJECT(m_radio), "focus_in_event", + GTK_SIGNAL_FUNC(gtk_radiobutton_focus_in), (gpointer)this ); + + gtk_signal_connect( GTK_OBJECT(m_radio), "focus_out_event", + GTK_SIGNAL_FUNC(gtk_radiobutton_focus_out), (gpointer)this ); + } + + m_parent->DoAddChild( this ); + + PostCreation(size); + + return true; +} + +wxRadioBox::~wxRadioBox() +{ + wxList::compatibility_iterator node = m_boxes.GetFirst(); + while (node) + { + GtkWidget *button = GTK_WIDGET( node->GetData() ); + gtk_widget_destroy( button ); + node = node->GetNext(); + } +} + +bool wxRadioBox::Show(bool show) +{ + wxCHECK_MSG( m_widget != NULL, false, wxT("invalid radiobox") ); + + if (!wxControl::Show(show)) + { + // nothing to do + return false; + } + + if ( HasFlag(wxNO_BORDER) ) + gtk_widget_hide( m_widget ); + + wxList::compatibility_iterator node = m_boxes.GetFirst(); + while (node) + { + GtkWidget *button = GTK_WIDGET( node->GetData() ); + + if (show) + gtk_widget_show( button ); + else + gtk_widget_hide( button ); + + node = node->GetNext(); + } + + return true; +} + +void wxRadioBox::SetFocus() +{ + wxCHECK_RET( m_widget != NULL, wxT("invalid radiobox") ); + + if (m_boxes.GetCount() == 0) return; + + wxList::compatibility_iterator node = m_boxes.GetFirst(); + while (node) + { + GtkToggleButton *button = GTK_TOGGLE_BUTTON( node->GetData() ); + if (button->active) + { + gtk_widget_grab_focus( GTK_WIDGET(button) ); + return; + } + node = node->GetNext(); + } +} + +void wxRadioBox::SetSelection( int n ) +{ + wxCHECK_RET( m_widget != NULL, wxT("invalid radiobox") ); + + wxList::compatibility_iterator node = m_boxes.Item( n ); + + wxCHECK_RET( node, wxT("radiobox wrong index") ); + + GtkToggleButton *button = GTK_TOGGLE_BUTTON( node->GetData() ); + + GtkDisableEvents(); + + gtk_toggle_button_set_active( button, 1 ); + + GtkEnableEvents(); +} int wxRadioBox::GetSelection(void) const { - GSList *item = gtk_radio_button_group( m_radio ); - int count = 0; - while (item) - { - GtkButton *button = GTK_BUTTON( item->data ); - if (GTK_TOGGLE_BUTTON(button)->active) return count; - count++; - item = item->next; - }; - return -1; -}; + wxCHECK_MSG( m_widget != NULL, wxNOT_FOUND, wxT("invalid radiobox") ); + + int count = 0; + + wxList::compatibility_iterator node = m_boxes.GetFirst(); + while (node) + { + GtkToggleButton *button = GTK_TOGGLE_BUTTON( node->GetData() ); + if (button->active) return count; + count++; + node = node->GetNext(); + } + + wxFAIL_MSG( wxT("wxRadioBox none selected") ); -wxString wxRadioBox::GetString( int WXUNUSED(n) ) const + return wxNOT_FOUND; +} + +wxString wxRadioBox::GetString(unsigned int n) const { - return ""; -}; + wxCHECK_MSG( m_widget != NULL, wxEmptyString, wxT("invalid radiobox") ); + + wxList::compatibility_iterator node = m_boxes.Item( n ); + + wxCHECK_MSG( node, wxEmptyString, wxT("radiobox wrong index") ); + + GtkLabel *label = GTK_LABEL( BUTTON_CHILD(node->GetData()) ); + + wxString str( label->label ); -wxString wxRadioBox::GetLabel(void) const + return str; +} + +void wxRadioBox::SetLabel( const wxString& label ) { - return wxControl::GetLabel(); -}; + wxCHECK_RET( m_widget != NULL, wxT("invalid radiobox") ); + + GTKSetLabelForFrame(GTK_FRAME(m_widget), label); +} -void wxRadioBox::SetLabel( const wxString& WXUNUSED(label) ) +void wxRadioBox::SetString(unsigned int item, const wxString& label) { -}; + wxCHECK_RET( m_widget != NULL, wxT("invalid radiobox") ); + + wxList::compatibility_iterator node = m_boxes.Item( item ); + + wxCHECK_RET( node, wxT("radiobox wrong index") ); + + GtkLabel *g_label = GTK_LABEL( BUTTON_CHILD(node->GetData()) ); -void wxRadioBox::SetLabel( int WXUNUSED(item), const wxString& WXUNUSED(label) ) + gtk_label_set( g_label, wxGTK_CONV( label ) ); +} + +bool wxRadioBox::Enable( bool enable ) { -}; + if ( !wxControl::Enable( enable ) ) + return false; + + wxList::compatibility_iterator node = m_boxes.GetFirst(); + while (node) + { + GtkButton *button = GTK_BUTTON( node->GetData() ); + GtkLabel *label = GTK_LABEL( BUTTON_CHILD(button) ); + + gtk_widget_set_sensitive( GTK_WIDGET(button), enable ); + gtk_widget_set_sensitive( GTK_WIDGET(label), enable ); + node = node->GetNext(); + } -void wxRadioBox::SetLabel( int WXUNUSED(item), wxBitmap *WXUNUSED(bitmap) ) + return true; +} + +bool wxRadioBox::Enable(unsigned int item, bool enable) { -}; + wxCHECK_MSG( m_widget != NULL, false, wxT("invalid radiobox") ); + + wxList::compatibility_iterator node = m_boxes.Item( item ); + + wxCHECK_MSG( node, false, wxT("radiobox wrong index") ); + + GtkButton *button = GTK_BUTTON( node->GetData() ); + GtkLabel *label = GTK_LABEL( BUTTON_CHILD(button) ); + + gtk_widget_set_sensitive( GTK_WIDGET(button), enable ); + gtk_widget_set_sensitive( GTK_WIDGET(label), enable ); -wxString wxRadioBox::GetLabel( int WXUNUSED(item) ) const + return true; +} + +bool wxRadioBox::IsItemEnabled(unsigned int item) const { - return ""; -}; + wxCHECK_MSG( m_widget != NULL, false, wxT("invalid radiobox") ); + + wxList::compatibility_iterator node = m_boxes.Item( item ); + + wxCHECK_MSG( node, false, wxT("radiobox wrong index") ); + + GtkButton *button = GTK_BUTTON( node->GetData() ); + + // don't use GTK_WIDGET_IS_SENSITIVE() here, we want to return true even if + // the parent radiobox is disabled + return GTK_WIDGET_SENSITIVE(GTK_WIDGET(button)); +} -void wxRadioBox::Enable( bool WXUNUSED(enable) ) +bool wxRadioBox::Show(unsigned int item, bool show) { -}; + wxCHECK_MSG( m_widget != NULL, false, wxT("invalid radiobox") ); -void wxRadioBox::Enable( int WXUNUSED(item), bool WXUNUSED(enable) ) + wxList::compatibility_iterator node = m_boxes.Item( item ); + + wxCHECK_MSG( node, false, wxT("radiobox wrong index") ); + + GtkWidget *button = GTK_WIDGET( node->GetData() ); + + if (show) + gtk_widget_show( button ); + else + gtk_widget_hide( button ); + + return true; +} + +bool wxRadioBox::IsItemShown(unsigned int item) const { -}; + wxCHECK_MSG( m_widget != NULL, false, wxT("invalid radiobox") ); + + wxList::compatibility_iterator node = m_boxes.Item( item ); + + wxCHECK_MSG( node, false, wxT("radiobox wrong index") ); + + GtkButton *button = GTK_BUTTON( node->GetData() ); + + return GTK_WIDGET_VISIBLE(GTK_WIDGET(button)); +} -void wxRadioBox::Show( int WXUNUSED(item), bool WXUNUSED(show) ) +unsigned int wxRadioBox::GetCount() const { -}; + return m_boxes.GetCount(); +} -wxString wxRadioBox::GetStringSelection(void) const +void wxRadioBox::GtkDisableEvents() { - GSList *item = gtk_radio_button_group( m_radio ); - while (item) - { - GtkButton *button = GTK_BUTTON( item->data ); - if (GTK_TOGGLE_BUTTON(button)->active) + wxList::compatibility_iterator node = m_boxes.GetFirst(); + while (node) { - GtkLabel *label = GTK_LABEL( button->child ); - return label->label; - }; - item = item->next; - }; - return ""; -}; + gtk_signal_disconnect_by_func( GTK_OBJECT(node->GetData()), + GTK_SIGNAL_FUNC(gtk_radiobutton_clicked_callback), (gpointer*)this ); -bool wxRadioBox::SetStringSelection( const wxString& WXUNUSED(s) ) + node = node->GetNext(); + } +} + +void wxRadioBox::GtkEnableEvents() { - return TRUE; -}; + wxList::compatibility_iterator node = m_boxes.GetFirst(); + while (node) + { + gtk_signal_connect( GTK_OBJECT(node->GetData()), "clicked", + GTK_SIGNAL_FUNC(gtk_radiobutton_clicked_callback), (gpointer*)this ); + + node = node->GetNext(); + } +} -int wxRadioBox::Number(void) const +void wxRadioBox::DoApplyWidgetStyle(GtkRcStyle *style) { - int count = 0; - GSList *item = gtk_radio_button_group( m_radio ); - while (item) - { - item = item->next; - count++; - }; - return count; -}; + gtk_widget_modify_style( m_widget, style ); + + wxList::compatibility_iterator node = m_boxes.GetFirst(); + while (node) + { + GtkWidget *widget = GTK_WIDGET( node->GetData() ); -int wxRadioBox::GetNumberOfRowsOrCols(void) const + gtk_widget_modify_style( widget, style ); + gtk_widget_modify_style( BUTTON_CHILD(node->GetData()), style ); + + node = node->GetNext(); + } +} + +#if wxUSE_TOOLTIPS +void wxRadioBox::ApplyToolTip( GtkTooltips *tips, const wxChar *tip ) { - return 1; -}; + wxList::compatibility_iterator node = m_boxes.GetFirst(); + while (node) + { + GtkWidget *widget = GTK_WIDGET( node->GetData() ); + gtk_tooltips_set_tip( tips, widget, wxConvCurrent->cWX2MB(tip), (gchar*) NULL ); + node = node->GetNext(); + } +} +#endif // wxUSE_TOOLTIPS + +bool wxRadioBox::IsOwnGtkWindow( GdkWindow *window ) +{ + if (window == m_widget->window) + return true; -void wxRadioBox::SetNumberOfRowsOrCols( int WXUNUSED(n) ) + wxList::compatibility_iterator node = m_boxes.GetFirst(); + while (node) + { + GtkWidget *button = GTK_WIDGET( node->GetData() ); + + if (window == button->window) + return true; + + node = node->GetNext(); + } + + return false; +} + +void wxRadioBox::OnInternalIdle() { -}; + if ( m_lostFocus ) + { + m_hasFocus = false; + m_lostFocus = false; + wxFocusEvent event( wxEVT_KILL_FOCUS, GetId() ); + event.SetEventObject( this ); + + (void)HandleWindowEvent( event ); + } + + if (g_delayedFocus == this) + { + if (GTK_WIDGET_REALIZED(m_widget)) + { + g_delayedFocus = NULL; + SetFocus(); + } + } +} + +// static +wxVisualAttributes +wxRadioBox::GetClassDefaultAttributes(wxWindowVariant WXUNUSED(variant)) +{ + wxVisualAttributes attr; + // NB: we need toplevel window so that GTK+ can find the right style + GtkWidget *wnd = gtk_window_new(GTK_WINDOW_TOPLEVEL); + GtkWidget* widget = gtk_radio_button_new_with_label(NULL, ""); + gtk_container_add(GTK_CONTAINER(wnd), widget); + attr = GetDefaultAttributesFromGTKWidget(widget); + gtk_widget_destroy(wnd); + return attr; +} + +#endif // wxUSE_RADIOBOX