epoc32/include/mw/asclisoundplay.h
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:33:34 +0100
branchSymbian3
changeset 4 837f303aceeb
parent 3 e1b950c65cb4
permissions -rw-r--r--
Current Symbian^3 public API header files (from PDK 3.0.h)
This is the epoc32/include tree with the "platform" subtrees removed, and
all but a selected few mbg and rsg files removed.
williamr@2
     1
// Copyright (c) 1999-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2
     2
// All rights reserved.
williamr@2
     3
// This component and the accompanying materials are made available
williamr@4
     4
// under the terms of "Eclipse Public License v1.0"
williamr@2
     5
// which accompanies this distribution, and is available
williamr@4
     6
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@2
     7
//
williamr@2
     8
// Initial Contributors:
williamr@2
     9
// Nokia Corporation - initial contribution.
williamr@2
    10
//
williamr@2
    11
// Contributors:
williamr@2
    12
//
williamr@2
    13
// Description:
williamr@2
    14
//
williamr@2
    15
williamr@2
    16
#ifndef __ASCLISOUNDPLAY_H__
williamr@2
    17
#define __ASCLISOUNDPLAY_H__
williamr@2
    18
williamr@2
    19
// System includes
williamr@2
    20
#include <e32base.h>
williamr@2
    21
williamr@2
    22
// User includes
williamr@2
    23
#include <asshddefs.h>
williamr@2
    24
williamr@2
    25
// Type definitions
williamr@2
    26
williamr@2
    27
// Constants
williamr@2
    28
williamr@2
    29
// Enumerations
williamr@2
    30
williamr@2
    31
williamr@4
    32
//
williamr@2
    33
// ----> TASCliSoundPlayDefinition (header)
williamr@4
    34
//
williamr@2
    35
class TASCliSoundPlayDefinition
williamr@2
    36
/** Defines when alarm sounds are to be played, and for how long. 
williamr@2
    37
williamr@2
    38
Alarm sounds are played according to intervals that consist of a duration 
williamr@2
    39
and an offset. 
williamr@2
    40
williamr@2
    41
The duration is the number of seconds that the alarm sound plays. 
williamr@2
    42
williamr@2
    43
The offset is the number of minutes after the alarm expires that the alarm 
williamr@2
    44
sound plays. 
williamr@2
    45
williamr@2
    46
The sound play definition is set using class RASCliSession. 
williamr@2
    47
@publishedAll
williamr@2
    48
@released
williamr@2
    49
*/
williamr@2
    50
	{
williamr@4
    51
//
williamr@2
    52
public:										// CONSTRUCT
williamr@4
    53
//
williamr@2
    54
williamr@2
    55
	inline TASCliSoundPlayDefinition();
williamr@2
    56
williamr@2
    57
	inline TASCliSoundPlayDefinition(TTimeIntervalMinutes aOffset, TTimeIntervalSeconds aDuration);
williamr@2
    58
williamr@4
    59
//
williamr@2
    60
public:										// ACCESS
williamr@4
    61
//
williamr@2
    62
williamr@2
    63
	inline TTimeIntervalMinutes	Offset() const 
williamr@2
    64
	/** Retrieves the offset.
williamr@2
    65
	
williamr@2
    66
	@return The offset in minutes. */
williamr@2
    67
		{ return iOffset; }
williamr@2
    68
williamr@2
    69
	inline TTimeIntervalSeconds	Duration() const 
williamr@2
    70
	/** Retrieves the duration.
williamr@2
    71
	
williamr@2
    72
	@return The duration in seconds. */
williamr@2
    73
		{ return iDuration; }
williamr@2
    74
williamr@4
    75
//
williamr@2
    76
private:									// MEMBER DATA
williamr@4
    77
//
williamr@2
    78
williamr@2
    79
	/*
williamr@2
    80
	 * From the time an alarm is first displayed
williamr@2
    81
	 */
williamr@2
    82
	TTimeIntervalMinutes					iOffset;
williamr@2
    83
williamr@2
    84
	/*
williamr@2
    85
	 * How long the alarm playing lasts
williamr@2
    86
	 */
williamr@2
    87
	TTimeIntervalSeconds					iDuration;
williamr@2
    88
	};
williamr@2
    89
williamr@2
    90
williamr@2
    91
williamr@2
    92
williamr@4
    93
//
williamr@2
    94
// ----> TASCliSoundPlayDefinition (inlines)
williamr@4
    95
//
williamr@2
    96
inline TASCliSoundPlayDefinition::TASCliSoundPlayDefinition()
williamr@2
    97
:	iOffset(KDefaultSoundPlayOffsetInSeconds), iDuration(KDefaultSoundPlayDurationInSeconds)
williamr@2
    98
/** Default constructor. 
williamr@2
    99
williamr@2
   100
The default offset is zero, and the default duration is 30 seconds. */
williamr@2
   101
	{}
williamr@2
   102
inline TASCliSoundPlayDefinition::TASCliSoundPlayDefinition(TTimeIntervalMinutes aOffset, TTimeIntervalSeconds aDuration)
williamr@2
   103
:	iOffset(aOffset), iDuration(aDuration)
williamr@2
   104
/** Constructor that initializes the offset and duration to specified values.
williamr@2
   105
	
williamr@2
   106
@param aOffset Time in minutes for the offset. 
williamr@2
   107
@param aDuration Time in seconds for the duration. */
williamr@2
   108
	{}
williamr@2
   109
williamr@2
   110
#endif