/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 *
 * The contents of this file are subject to the Netscape Public License
 * Version 1.0 (the "NPL"); you may not use this file except in
 * compliance with the NPL.  You may obtain a copy of the NPL at
 * http://www.mozilla.org/NPL/
 *
 * Software distributed under the NPL is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the NPL
 * for the specific language governing rights and limitations under the
 * NPL.
 *
 * The Initial Developer of this code under the NPL is Netscape
 * Communications Corporation.  Portions created by Netscape are
 * Copyright (C) 1998 Netscape Communications Corporation.  All Rights
 * Reserved.
 */



// UIHelper.h

#pragma once

///////////////////////////////////////////////////////////////////////////////////
//
// 	This file contains some helper functions for UI manipulation.
//
///////////////////////////////////////////////////////////////////////////////////
//
// 	FindUIItemPtr - returns a pointer to the proper item
//	Usage:
//
//		LGAPushButton*	button;
//		LView			view;
//		PaneIDT			paneID;
//
//		FindUIItem( view, paneID, button );
//
//	It will throw an exception if the element is missing or the passed
//	pointer is the wrong type.
//
///////////////////////////////////////////////////////////////////////////////////

#include "PP_Types.h"
#include "LView.h"
#include "nc_exception.h"

///////////////////////////////////////////////////////////////////////////////////
// FindUIItemPtr
template <class T>
inline
void
FindUIItemPtr( LView *inView, long inID, T*& outItemPtr )
{
	outItemPtr = dynamic_cast<T*>( inView->FindPaneByID( inID ) );
	if( !outItemPtr )
		throw nc_exception( eUIResourceError );
}
