Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License
"Eclipse Public License v1.0" which accompanies this distribution,
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
Nokia Corporation - initial contribution.
Contributors:
-->
<!DOCTYPE task
PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="GUID-623CA1EE-4D25-495A-BD2F-BA7BF95D6D9C" xml:lang="en"><title>Creating
a Vibra instance to control the vibra</title><prolog><metadata><keywords/></metadata></prolog><taskbody>
<context> <p>A <codeph>CHWRMVibra</codeph> instance can be created by
using <codeph>NewL()</codeph> or <codeph>NewLC()</codeph> methods. After this,
vibra can be directly controlled via the provided class methods.</p><p><b>Without
notify handling</b></p><p>The user has to create an instance of the <codeph>CHWRMVibra</codeph> implementation
class using the <codeph>NewL()</codeph> or <codeph>NewLC()</codeph> constructor
without a parameter. The following code snippet demonstrates how to create
an instance without notify handling to control the device vibra:</p><codeblock xml:space="preserve">CHWRMVibra* vibra = CHWRMVibra::NewLC(); // No callbacks</codeblock><p><b>With notify handling </b></p><p>The client must derive a class from
the <codeph>MHWRMVibraObserver</codeph> interface and implement the <codeph>VibraModeChanged()</codeph> and <codeph>VibraStatusChanged()</codeph> methods.</p><p>The following code snippet gives an example of the header of the class
implemented by the client:</p><codeblock xml:space="preserve">// INCLUDES
#include HWRMVibra.h // Link against HWRMVibraClient.lib.
class CVibraStatusObserver : public CBase,
public MHWRMVibraObserver
{
public:
CVibraStatusObserver();
~CVibraStatusObserver();
void ConstructL();
static CVibraStatusObserver* NewL();
// from MHWRMVibraObserver
virtual void VibraModeChanged( CHWRMVibra::TVibraModeState aStatus );
virtual void VibraStatusChanged( CHWRMVibra::TVibraStatus aStatus );
private:
CHWRMVibra* iVibra;
};
</codeblock><p>Create an instance of the <codeph>CHWRMVibra</codeph> implementation
class using the <codeph>NewL()</codeph> or <codeph>NewLC()</codeph> constructor
with a parameter. This parameter is a pointer to an object that is derived
from <codeph>MHWRMVibraObserver</codeph>. Every vibra user setting profile
change causes the notification using <codeph>MHWRMVibraObserver::VibraModeChanged()</codeph>.
Every vibra status change causes the notification using <codeph>MHWRMVibraObserver::VibraStatusChanged()</codeph>. </p><p>The
following code snippet demonstrates how to create an instance with notify
handling to control the device vibra:</p><codeblock xml:space="preserve">void CVibraStatusObserver::ConstructL()
{
iVibra = CHWRMVibra::NewL( this )
}</codeblock></context>
</taskbody></task>