Overview Package Class Source Class tree Glossary
previous class      next class frames      no frames

UTGame.UTUITabPage_ServerBrowser

Extends
UTTabPage
Modifiers
placeable

Copyright 1998-2007 Epic Games, Inc. All Rights Reserved. Tab page for a server browser.

Core.Object
|   
+-- Engine.UIRoot
   |   
   +-- Engine.UIScreenObject
      |   
      +-- Engine.UIObject
         |   
         +-- Engine.UIContainer
            |   
            +-- Engine.UITabPage
               |   
               +-- UTGame.UTTabPage
                  |   
                  +-- UTGame.UTUITabPage_ServerBrowser

Direct Known Subclasses:

UTUITabPage_FindQuickMatch, UTUITabPage_ServerHistory

Constants Summary
SERVERBROWSER_SERVERTYPE_LAN=0
SERVERBROWSER_SERVERTYPE_RANKED=2
SERVERBROWSER_SERVERTYPE_UNRANKED=1
Inherited Contants from Engine.UITabPage
CAPTION_DATABINDING_INDEX, DESCRIPTION_DATABINDING_INDEX, TOOLTIP_DATABINDING_INDEX

Variables Summary
intBackButtonIdx
boolbGametypeOutdated
boolbSpectate
intCancelButtonIdx
intDetailsButtonIdx
UIListDetailsList
OnlineGameInterfaceGameInterface
UTUIComboBoxGameTypeCombo
intJoinButtonIdx
UTUIDataStore_MenuItemsMenuItemDataStore
UIListMutatorList
OnlineSubsystemOnlineSub
EQueryCompletionActionQueryCompletionAction
intRefreshButtonIdx
UIObjectRefreshingLabel
UTDataStore_GameSearchBaseSearchDataStore
nameSearchDSName
UIToolTipServerBrowserToolTip
UILabelServerCountLabel
UIListServerList
stringServerPassword
intSpectateButtonIdx
UTUIDataStore_StringListStringListDataStore
Inherited Variables from UTGame.UTTabPage
bRequiresTick
Inherited Variables from Engine.UITabPage
ButtonCaption, ButtonClass, ButtonToolTip, PageDescription, TabButton

Enumerations Summary
EQueryCompletionAction
QUERYACTION_None, QUERYACTION_Default, QUERYACTION_CloseScene, QUERYACTION_JoinServer, QUERYACTION_RefreshAll,

Delegates Summary
delegatetransient OnBack ()
delegatetransient OnPrepareToSubmitQuery (UTUITabPage_ServerBrowser Sender)
delegatetransient OnSwitchedGameType ()
Inherited Delegates from UTGame.UTTabPage
OnTick

Functions Summary
eventbool ActivatePage (int PlayerIndex, bool bActivate, optional bool bTakeFocus=true ))
function AdjustLayout ()))
functionbool AllowCloseScene ()))
functionbool AllowJoinServer ()))
functionstring BuildJoinURL (string ResolvedConnectionURL))
function CancelQuery (optional EQueryCompletionAction DesiredCancelAction=QUERYACTION_Default ))
functionbool CheckToolTipPosition (UIToolTip Sender ))
function Cleanup ()))
function ConditionalRefreshServerList (int PlayerIndex ))
functionUTUIButtonBarButton GetButtonBarButton (int ButtonIndex ))
functionint GetDesiredMatchType ()))
functionint GetGameTypeSearchProviderIndex (optional string GameClassName ))
functionbool HandleInputKey (const out InputEventParameters EventParms ))
function JoinServer ()))
function MessageBoxClosed ()))
function NotifyGameTypeChanged ()))
functionbool OnButtonBar_Back (UIScreenObject InButton, int InPlayerIndex))
functionbool OnButtonBar_CancelQuery (UIScreenObject InButton, int inPlayerIndex ))
functionbool OnButtonBar_JoinServer (UIScreenObject InButton, int InPlayerIndex))
functionbool OnButtonBar_Refresh (UIScreenObject InButton, int InPlayerIndex))
functionbool OnButtonBar_ServerDetails (UIScreenObject InButton, int InPlayerIndex ))
functionbool OnButtonBar_SpectateServer (UIScreenObject InButton, int InPlayerIndex))
function OnCancelSearchComplete (bool bWasSuccessful ))
function OnFindOnlineGamesComplete (bool bWasSuccessful))
function OnFindOnlineGamesCompleteDelegate (bool bWasSuccessful))
function OnGameTypeChanged (UIObject Sender, int PlayerIndex ))
function OnJoinGameComplete (bool bSuccessful))
function OnPasswordDialog_Closed (UTUIScene_MessageBox MessageBox, int SelectedOption, int PlayerIndex))
function OnServerList_SubmitSelection (UIList Sender, int PlayerIndex ))
function OnServerList_ValueChanged (UIObject Sender, int PlayerIndex ))
event PostInitialize ()))
function ProcessJoin ()))
function PromptForServerPassword ()))
functionbool QueryServerBrowserTooltip (UIObject Sender, out UIToolTip CustomToolTip ))
function RefreshDetailsList ()))
function RefreshServerList (int InPlayerIndex, optional int MaxResults=1000))
functionbool ServerIsPrivate ()))
function ServerListResorted (UIList Sender ))
function SetupButtonBar (UTUIButtonBar ButtonBar))
function ShowServerDetails ()))
function SubmitServerListQuery (int PlayerIndex ))
function UpdateButtonStates ()))
function UpdateServerCount ()))
Inherited Functions from UTGame.UTTabPage
CloseParentScene, HandleInputKey, OnChildRepositioned, SetupButtonBar
Inherited Functions from Engine.UITabPage
ActivatePage, AddedToTabControl, CanActivatePage, ClearBoundDataStores, CreateTabButton, GetBoundDataStores, GetDataStoreBinding, GetOwnerTabControl, GetTabButton, IsActivePage, LinkToTabButton, NotifyDataStoreValueUpdated, OnActiveStateChanged, RefreshSubscriberValue, RemovedFromParent, SetDataStoreBinding, SetTabCaption


Constants Detail

SERVERBROWSER_SERVERTYPE_LAN Source code

const SERVERBROWSER_SERVERTYPE_LAN = 0;

SERVERBROWSER_SERVERTYPE_RANKED Source code

const SERVERBROWSER_SERVERTYPE_RANKED = 2;

SERVERBROWSER_SERVERTYPE_UNRANKED Source code

const SERVERBROWSER_SERVERTYPE_UNRANKED = 1;


Variables Detail

BackButtonIdx Source code

var transient int BackButtonIdx;
Indices for the button bar buttons

bGametypeOutdated Source code

var private transient bool bGametypeOutdated;
Indicates that the current gametype was changed externally - submit a new query when possible

bSpectate Source code

var private transient bool bSpectate;
Indicates that the current gametype was changed externally - submit a new query when possible

CancelButtonIdx Source code

var transient int CancelButtonIdx;
Indices for the button bar buttons

DetailsButtonIdx Source code

var transient int DetailsButtonIdx;
Indices for the button bar buttons

DetailsList Source code

var transient UIList DetailsList;
Reference to the list of rules for the selected server

GameInterface Source code

var transient OnlineGameInterface GameInterface;
Cached game interface pointer

GameTypeCombo Source code

var transient UTUIComboBox GameTypeCombo;
Reference to the combobox containing the gametypes

JoinButtonIdx Source code

var transient int JoinButtonIdx;
Indices for the button bar buttons

MenuItemDataStore Source code

var transient UTUIDataStore_MenuItems MenuItemDataStore;
Reference to the menu item datastore.

MutatorList Source code

var transient UIList MutatorList;
reference to the list of mutators for the selected server

OnlineSub Source code

var transient OnlineSubsystem OnlineSub;
Cached online subsystem pointer

QueryCompletionAction Source code

var private EQueryCompletionAction QueryCompletionAction;
Different actions to take when a query completes.

RefreshButtonIdx Source code

var transient int RefreshButtonIdx;
Indices for the button bar buttons

RefreshingLabel Source code

var transient UIObject RefreshingLabel;
Reference to a label to display when refreshing.

SearchDataStore Source code

var transient UTDataStore_GameSearchBase SearchDataStore;
Reference to the search datastore.

SearchDSName Source code

var protected transient const name SearchDSName;

ServerBrowserToolTip Source code

var private transient UIToolTip ServerBrowserToolTip;
Tooltip which displays the legend for the SB icons

ServerCountLabel Source code

var transient UILabel ServerCountLabel;
Reference to the label which displays the number of servers currently loaded in the list

ServerList Source code

var transient UIList ServerList;
Reference to the list of servers

ServerPassword Source code

var private transient string ServerPassword;
stores the password entered by the user when attempting to connect to a server with a password

SpectateButtonIdx Source code

var transient int SpectateButtonIdx;
Indices for the button bar buttons

StringListDataStore Source code

var transient UTUIDataStore_StringList StringListDataStore;
Reference to the string list datastore.


Enumerations Detail

EQueryCompletionAction Source code

enum EQueryCompletionAction
{
QUERYACTION_None, QUERYACTION_Default, QUERYACTION_CloseScene, QUERYACTION_JoinServer, QUERYACTION_RefreshAll,
};


Delegates Detail

OnBack Source code

delegate transient OnBack ( )
Go back delegate for this page.

OnPrepareToSubmitQuery Source code

delegate transient OnPrepareToSubmitQuery ( UTUITabPage_ServerBrowser Sender )
Called when we're about the submit a server query. Usual thing to do is make sure the GameSearch object is up to date

OnSwitchedGameType Source code

delegate transient OnSwitchedGameType ( )
Called when the user changes the game type using the combo box


Functions Detail

ActivatePage Source code

event bool ActivatePage ( int PlayerIndex, bool bActivate, optional bool bTakeFocus=true ) )
Causes this page to become (or no longer be) the tab control's currently active page.
@param PlayerIndex the index [into the Engine.GamePlayers array] for the player that wishes to activate this page.
@param bActivate TRUE if this page should become the tab control's active page; FALSE if it is losing the active status.
@param bTakeFocus specify TRUE to give this panel focus once it's active (only relevant if bActivate = true)
@return TRUE if this page successfully changed its active state; FALSE otherwise.

AdjustLayout Source code

function AdjustLayout ( ) )
Adjusts the layout of the scene based on the current platform

AllowCloseScene Source code

function bool AllowCloseScene ( ) )
Determine if we're in the right state to close the "Join Game" scene (cancels any pending queries, etc.)
@return TRUE if closing the scene should be allowed; FALSE if there a query is still active - will close the scene when it's safe to do so.

AllowJoinServer Source code

function bool AllowJoinServer ( ) )
Determine if we're in the right state to join a server (cancels any pending queries, etc.)
@return TRUE if joining a server should be allowed; FALSE if there a query is still active - will join the server when it's safe to do so.

BuildJoinURL Source code

function string BuildJoinURL ( string ResolvedConnectionURL) )
Builds the string needed to join a game from the resolved connection: "open 172.168.0.1" NOTE: Overload this method to modify the URL before exec-ing it
@param ResolvedConnectionURL the platform specific URL information
@return the final URL to use to open the map

CancelQuery Source code

function CancelQuery ( optional EQueryCompletionAction DesiredCancelAction=QUERYACTION_Default ) )
Fires an asynchronous task to cancels all active queries.
@param DesiredCancelAction specifies what should happen when the asynchronous task completes.

CheckToolTipPosition Source code

function bool CheckToolTipPosition ( UIToolTip Sender ) )
Handler for the tooltip's CanShowToolTip delegate. Prevents the tooltip timer from being activated if the cursor is not over the correct [first] column.
@param ToolTip the tooltip, duh
@return TRUE to allow the tooltip to be made visible; FALSE to keep it hidden.

Cleanup Source code

function Cleanup ( ) )
Called when the owning scene is being closed - provides a hook for the tab page to ensure it's cleaned up all external references (i.e. delegates, etc.)

ConditionalRefreshServerList Source code

function ConditionalRefreshServerList ( int PlayerIndex ) )
Refreshes the server list by submitting a new query if certain conditions are met.

GetButtonBarButton Source code

final function UTUIButtonBarButton GetButtonBarButton ( int ButtonIndex ) )
Wrapper for grabbing a reference to a button bar button.

GetDesiredMatchType Source code

function int GetDesiredMatchType ( ) )

GetGameTypeSearchProviderIndex Source code

function int GetGameTypeSearchProviderIndex ( optional string GameClassName ) )
Retrieve the index in the game search data store's list of search results for the specified gametype class
@param GameClassName the path name of the gametype to find; if not specified, uses the currently selected gametype
@return the index into the UIDataStore_OnlineGameSearch's GameSearchCfgList array for the gametype specified.

HandleInputKey Source code

function bool HandleInputKey ( const out InputEventParameters EventParms ) )
Provides a hook for unrealscript to respond to input using actual input key names (i.e. Left, Tab, etc.) Called when an input key event is received which this widget responds to and is in the correct state to process. The keys and states widgets receive input for is managed through the UI editor's key binding dialog (F8). This delegate is called BEFORE kismet is given a chance to process the input.
@param EventParms information about the input event.
@return TRUE to indicate that this input key was processed; no further processing will occur on this input key event.

JoinServer Source code

function JoinServer ( ) )
Joins the currently selected server.

MessageBoxClosed Source code

function MessageBoxClosed ( ) )
Handler for the message box scene's OnClose delegate when we're displaying a modal dialog while waiting for the active query to complete.

NotifyGameTypeChanged Source code

function NotifyGameTypeChanged ( ) )
Notification that the currently selected gametype was changed externally. Update this tab page to reflect the new gametype.

OnButtonBar_Back Source code

function bool OnButtonBar_Back ( UIScreenObject InButton, int InPlayerIndex) )
ButtonBar - Back

OnButtonBar_CancelQuery Source code

function bool OnButtonBar_CancelQuery ( UIScreenObject InButton, int inPlayerIndex ) )

OnButtonBar_JoinServer Source code

function bool OnButtonBar_JoinServer ( UIScreenObject InButton, int InPlayerIndex) )
ButtonBar - JoinServer

OnButtonBar_Refresh Source code

function bool OnButtonBar_Refresh ( UIScreenObject InButton, int InPlayerIndex) )
ButtonBar - Refresh

OnButtonBar_ServerDetails Source code

function bool OnButtonBar_ServerDetails ( UIScreenObject InButton, int InPlayerIndex ) )
ButtonBar - ServerDetails (console only)

OnButtonBar_SpectateServer Source code

function bool OnButtonBar_SpectateServer ( UIScreenObject InButton, int InPlayerIndex) )

OnCancelSearchComplete Source code

function OnCancelSearchComplete ( bool bWasSuccessful ) )
Handler for the 'cancel query' asynchronous task completion. Performs the actions dictated by the current QueryCompletionAction, as set when CancelQuery was called.

OnFindOnlineGamesComplete Source code

function OnFindOnlineGamesComplete ( bool bWasSuccessful) )
Delegate fired when the search for an online game has completed
@param bWasSuccessful true if the async action completed without error, false if there was an error

OnFindOnlineGamesCompleteDelegate Source code

function OnFindOnlineGamesCompleteDelegate ( bool bWasSuccessful) )
Delegate fired each time a new server is recieved, or when the action completes (if there was an error)
@param bWasSuccessful true if the async action completed without error, false if there was an error

OnGameTypeChanged Source code

function OnGameTypeChanged ( UIObject Sender, int PlayerIndex ) )
Called when the user changes the currently selected gametype via the gametype combo.
@param Sender the UIObject whose value changed
@param PlayerIndex the index of the player that generated the call to this method; used as the PlayerIndex when activating UIEvents; if not specified, the value of GetBestPlayerIndex() is used instead.

OnJoinGameComplete Source code

function OnJoinGameComplete ( bool bSuccessful) )
Callback for when the join completes.

OnPasswordDialog_Closed Source code

private final function OnPasswordDialog_Closed ( UTUIScene_MessageBox MessageBox, int SelectedOption, int PlayerIndex) )
The user has made a selection of the choices available to them.

OnServerList_SubmitSelection Source code

function OnServerList_SubmitSelection ( UIList Sender, int PlayerIndex ) )
Server List - Submit Selection.

OnServerList_ValueChanged Source code

function OnServerList_ValueChanged ( UIObject Sender, int PlayerIndex ) )
Server List - Value Changed.

PostInitialize Source code

event PostInitialize ( ) )
PostInitialize event - Sets delegates for the page.

ProcessJoin Source code

private function ProcessJoin ( ) )

PromptForServerPassword Source code

private final function PromptForServerPassword ( ) )
Displays a dialog to the user which allows him to enter the password for the currently selected server.

QueryServerBrowserTooltip Source code

function bool QueryServerBrowserTooltip ( UIObject Sender, out UIToolTip CustomToolTip ) )
Called when this widget (or one of its children) becomes the ActiveControl. Provides a way for child classes or containers to easily override or short-circuit the standard tooltip that is normally shown. If this delegate is not assigned to any function, the default tool-tip will be displayed if this widget has a data store binding property named "ToolTipBinding" which is bound to a valid data store.
@param Sender the widget that will be displaying the tooltip
@param CustomToolTip to provide a custom tooltip implementation, fill in in this value and return TRUE. The custom tool tip object will then be activated by native code.
@return return FALSE to prevent any tool-tips from being shown, including parents.

RefreshDetailsList Source code

function RefreshDetailsList ( ) )
Refreshes the game details list using the currently selected item in the server list.

RefreshServerList Source code

function RefreshServerList ( int InPlayerIndex, optional int MaxResults=1000) )
Refreshes the server list.

ServerIsPrivate Source code

function bool ServerIsPrivate ( ) )
Determines if the currently selected server is password protected.
@return TRUE if a valid server is selected and it is password protected; FALSE otherwise.

ServerListResorted Source code

function ServerListResorted ( UIList Sender ) )
called when the list is resorted (can be triggered by manual resort from user input or automatic resort from new elements added

SetupButtonBar Source code

function SetupButtonBar ( UTUIButtonBar ButtonBar) )
Sets buttons for the scene.

ShowServerDetails Source code

function ShowServerDetails ( ) )
Opens a custom UIScene which displays more verbose details about the server currently selected in the server browser. Console only.

SubmitServerListQuery Source code

function SubmitServerListQuery ( int PlayerIndex ) )
Submits a query for the list of servers which match the current configuration.

UpdateButtonStates Source code

function UpdateButtonStates ( ) )
Updates the enabled state of certain button bar buttons depending on whether a server is selected or not.

UpdateServerCount Source code

function UpdateServerCount ( ) )
Updates the server count label with the number of servers received so far for the currently selected gametype.


Defaultproperties

defaultproperties
{
   Begin Object Class=UIComp_Event Name=WidgetEventComponent ObjName=WidgetEventComponent Archetype=UIComp_Event'UTGame.Default__UTTabPage:WidgetEventComponent'
      ObjectArchetype=UIComp_Event'UTGame.Default__UTTabPage:WidgetEventComponent'
   End Object
   EventProvider=WidgetEventComponent
   Name="Default__UTUITabPage_ServerBrowser"
   ObjectArchetype=UTTabPage'UTGame.Default__UTTabPage'
}

Overview Package Class Source Class tree Glossary
previous class      next class frames      no frames
Creation time: Mon 26/11/2007 17:41:35.171 - Created with UnCodeX